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Kantronics Warranty Registration 
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Kantronics in order for you to receive warranty service. Refer to the warranty 
policy in this manual for further information. 
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License Agreement 


IMPORTANT: READ THIS PAGE BEFORE YOU 
INSTALL YOUR NEW KANTRONICS PRODUCT 


This product contains SOFTWARE on Programmable Read Only Memory 
(PROM) and/or diskette which is protected by both United States copyright law 
and international treaty provisions. 


If you install or use this product , you will be deemed to be bound by the terms of 
the SOFTWARE license shown below. If you do not wish to be bound by such 
license, return such product and all associated documentation unused to your 
supplier for refund of the amount you paid. 


License Agreement 


1. License. In consideration of payment of the License Fee, which is included in 
the price of the product, the Licensee (you) is granted by the Licensor 
(Kantronics Company, Inc. - Kantronics) a non-exclusive right to use the 
SOFTWARE and associated documentation. No ownership rights to the 
SOFTWARE or its Documentation are transferred from Kantronics to you. 


2. Term. This License Agreement is effective until terminated. You may termi- 
nate this Agreement by destroying the PROM or diskette and documentation. 
You may not rent or lease the SOFTWARE, but you may transfer the SOFT- 
WARE and accompanying written materials on a permanent basis provided you 
retain no copies and the recipient agrees to the terms of this Agreement. 
Kantronics may terminate this Agreement without notice if you violate any terms 
or conditions of the Agreement. In the event of termination of the Agreement, 
provisions relating to Kantronics’ disclaimers of warranties, limitation of liability, 
remedies, or damages and Kantronics’ proprietary rights shall survive. 


3. Object Code. The SOFTWARE is delivered in object code only. You shall not 
reverse compile or otherwise reverse engineer the SOFTWARE. 


4. Limited Warranty. This product is covered by the standard Kantronics Co., 
Inc. Limited Warranty, which is enclosed. 
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5. General. This License Agreement constitutes the complete Agreement 
between you and Kantronics. 


The SOFTWARE and/or Documentation may not be exported or re-exported in 
violation of any export laws or regulations of the United States of America or any 
other applicable jurisdiction. 


This Agreement shall be governed by and interpreted under the laws of the State 
of Kansas, United States of America. 


Use, duplication, or disclosure by the Government of the United States is subject 
to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical 
Data and Computer SOFTWARE clause of DFARS 252.227-7013. 


Kantronics may in its sole discretion, provide you with upgrades of the SOFT- 
WARE and/or Documentation if you have provided Kantronics your completed 
Warranty registration with a copy of your receipt showing the amount you paid. 


LICENSEE ACKNOWLEDGES HAVING READ AND UNDERSTOOD THIS 
AGREEMENT AND AGREES TO BE BOUND BY ITS TERMS. LICENSEE 
FURTHER AGREES THAT THIS AGREEMENT IS THE COMPLETE AND 
EXCLUSIVE STATEMENT OF THE AGREEMENT BETWEEN LICENSEE 
AND LICENSOR AND SUPERSEDES ANY PROPOSAL OR PRIOR 
AGREEMENT, ORAL OR WRITTEN, AND ANY OTHER COMMUNICA- 
TIONS RELATING TO THE SUBJECT MATTER OF THIS AGREEMENT. 


Any questions concerning this Agreement or any other matter relating to 
Kantronics Company, Inc. products or business practices may be directed to: 


Customer Service Department 
Kantronics Company, Inc. 
1202 E. 23rd Street, 
Lawrence, KS 66046 
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KANTRONICS CO., INC. 


LIMITED WARRANTY 
Effective January 1, 1997 


To receive notice of future updates, new product information and prompt war- 
ranty service, please fill in the Kantronics/rfconcepts Warranty Registration card 
COMPLETELY and return it along with a copy of proof of purchase (to estab- 
lish purchase date) to Kantronics Co., Inc., 1202 East 23rd Street, Lawrence, 
Kansas 66046 USA. 


NOTE: Return of the Warranty Registration card and proof of purchase is a 
pre-condition to warranty coverage. 


1. WARRANTY. Kantronics Co., Inc. (“Kantronics”) warrants to the first con- 
sumer purchaser (“you”), for the Applicable Warranty Period (as described 
below), that the Applicable Product (as described below) will be free from 
defects in material and workmanship. 


2. REMEDY. Kantronics agrees that, for any Applicable Product found by 
Kantronics to be in violation of the warranty of Section | hereof within the Ap- 
plicable Warranty Period, it will, at its option, repair or replace the defective Ap- 
plicable Product at no charge to you, excluding in-bound shipping charges. 


3. EXCLUSIVE REMEDY. Repair or replacement of the Applicable Product, as 
provided herein, is the sole remedy available to you against Kantronics, and in no 
event will Kantronics be responsible for any other liability or damages or for in- 
cidental, special, or consequential damages, regardless of whether purported lia- 
bility is predicated upon negligence, strict tort, contract, or other products 
liability theory and whether or not Kantronics is warned about the possibility of 
such liability or damages. SOME STATES DO NOT ALLOW THE EXCLU- 
SION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAM- 
AGES, SO THE ABOVE LIMITATION OR EXCLUSION MAY NOT 
APPLY TO YOU. 


4. DISCLAIMER. This Limited Warranty is in lieu of all other warranties ex- 
pressed or implied and no representative or person is authorized to assume for 
Kantronics any other liability in connection with the sale of its products. 
KANTRONICS SPECIFICALLY DISCLAIMS THE IMPLIED WARRANTY 
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OF MERCHANTABILITY AND IMPLIED WARRANTY OF FITNESS FOR 
A PARTICULAR PURPOSE FOR ANY APPLICABLE PRODUCT. IF, HOW- 
EVER, YOU ARE A CONSUMER WITHIN THE MEANING OF 15 U.S.C. 
2301(3), THE ABOVE DISCLAIMER OF IMPLIED WARRANTIES IS EF- 
FECTIVE ONLY FOR PERIODS OUTSIDE THE APPLICABLE WAR- 
RANTY PERIOD. SOME STATES DO NOT ALLOW LIMITATIONS ON 
HOW LONG AN IMPLIED WARRANTY LASTS, SO THE ABOVE LIMI- 
TATION MAY NOT APPLY TO YOU. 


5. APPLICABLE PRODUCTS AND PERIODS. Kantronics products are of 
two types - (1) hardware units and (2) firmware and software for operation of 
these units, whether incorporated into the units themselves or separate from the 
units as adjuncts or accessories to the units. Hardware units and the media con- 
taining firmware, software and documentation are sold to the consumer purchaser 
and become property of the purchaser. Firmware and software are licensed for 
use by the consumer purchaser in return for a fee included in the purchase price 
of the units and do not become the property of the consumer. (See separate Li- 
cense Agreement provided with these products). The products to which the war- 
ranty of Section | hereof applies (herein “Applicable Products”) and the periods 
during which the warranty shall apply to such products (herein, “Applicable War- 
ranty Period”) are as follows: 


Applicable Products: 


UNITS: 


KPC-9612, KPC-9612 Plus, KAM, KAM Plus, KPC-3, KPC-3 Plus, 
rfc 2/70, rfc 2/70G, rfc 4-110, rfc 4-310, Mini-Amp 144, Mini-Amp 144P, 
Mini-Amp 440, Mini-Amp 440P, MAX-Amp 10, MAX-Amp 45. 


Applicable Warranty Period: One (1) year from date of purchase. 


ACCESSORIES: 
KAM Enhancement Board 
Applicable Warranty Period: One (1) year from date of purchase. 
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MEDIA: 


EPROMS, diskettes, video or audio cassettes, manuals (however bound), specifi- 
cation and other supplemental pages or any other media on which firmware, soft- 
ware or documentation are supplied 


Applicable Warranty Period: Thirty (30) days from date of purchase. 


6. EXCLUSIONS. This Limited Warranty does not apply to the cosmetic ap- 
pearance of the Applicable Product; to broken or cracked cabinets; to any acces- 
sory not supplied by Kantronics which is used with the Applicable Product; to 
any product that has been subject to misuse abuse or overvoltage; to any product 
that has been modified by non-Kantronics personnel unless specifically autho- 
rized 

in writing by Kantronics; or to any product damaged or impaired by shipping 
(whether or not caused by poor packaging), neglect, accident, wiring not installed 
by Kantronics, improper parameter settings which are cleared by performing a 
hard reset, or use in violation of instructions furnished by Kantronics or of gener- 
ally accepted industry practice. Kantronics does not warrant that the functions 
contained in any software will meet your requirements or achieve your intended 
results; or that operation of any software will be uninterrupted or error-free or 
without effect upon other software used with it. Responsibility for the selection of 
the hardware and software program to achieve your intended results rests with 
you. 


7. REMEDY PROCEDURE. Should you need to make a warranty claim, first 
contact the dealer from whom you purchased the product. If the dealer is unable 
to assist you, contact Kantronics Co., Inc., by mail at 1202 East 23rd Street, Law- 
rence, Kansas 66046 USA; by fax at 785-842-2021; or by phone at our 

Service / Technical Support number 785-842-4476 (Hours: 1:00 p.m. - 5:00 p.m. 
Central Time, M-F). Contact us prior to returning an Applicable Product to re- 
ceive a Return Authorization Number. (As a practical matter, problems can often 
be solved in such a manner without the product having to be returned to 
Kantronics for repair or replacement.) 


Return of any Applicable Product for the enforcement of rights under this 
Limited Warranty shall be at your expense. Any product returned for warranty 
service which Kantronics determines to be without defect or not covered by this 
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Limited Warranty shall be subject to a minimum charge of one-half hour labor 
rate and the product will be returned to you at your sole expense. Please note, no 
warranty service will be provided until Kantronics has been furnished with your 
Warranty Registration card and copy of proof of purchase establishing purchase 
date. 


8. NON-ASSIGNMENT. This Limited Warranty is not assignable by you. Any 
attempt to assign or transfer any of the rights, duties, or obligations hereof is 
void. 


9. OTHER RIGHTS. This Limited Warranty gives you specific legal rights 
and you may also have other rights which vary from jurisdiction to jurisdic- 
tion. 
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Return/Repair Procedures 


Important: Our repair statistics show that over 70 percent of the units returned 
for service do not, in fact, require any service. Therefore, we advise you to please 
double-check the following list of common, user-solvable, sources of difficulty 
before contacting Kantronics about returning your unit for service. 


Check-List for Possible Problems 


Should you encounter difficulty in getting your equipment to “talk” to your com- 
puter, please perform at least the following limited checks before calling or writ- 
ing: 


e Carefully check your wiring connections to the RS-232 port. 


e If you purchased third-party cables, double-check to be sure that they 
conform to the Kantronics’ wiring instructions in this manual. 


e Verify your terminal baud rate. 
e Jt may be useful to perform a “Hard Reset”. (See Hard Reset section.) 


If service or repairs still appear necessary after you have checked the items listed 
above, it may be wise to call, fax, e-mail or write Kantronics to determine if the 
problem can be solved without returning the unit. 


Return Procedures 


When calling, report the product name and ask for the Amateur Radio Service 
Department. Please have the following information available: 


e The unit name and serial number (the serial number is found on the 
bottom of the unit). 


e The firmware version number (the version number is displayed when you 
give the Version command). 


If possible, you should have the unit and your computer available to 
perform troubleshooting operations when you call. 
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+ The Service Department telephone hours are 1:00 pm - 5:00 pm Central Time, 
Monday through Friday. If you call outside these hours, the phone will just ring. 
The service department telephone is not connected to the main switchboard and 
the switchboard receptionist cannot transfer you to the service number. If lines 
are busy, you may wish to (and it may be faster to) contact service by letter, fax, 
or e-mail. Service e-mail is currently checked twice per day. Before contacting 
us, please take the time to list out your problem fully and carefully. 

Here are the contact numbers: 


Kantronics Co., Inc. 
1202 E. 23rd Street 
Lawrence, KS 66046 


service phone line: 785-842-4476 

service fax line: 785-842-2021 

service e-mail address: service@kantronics.com 
website address: www.kantronics.com 


When writing, faxing, or e-mailing Kantronics, include a clear description of the 
problem, unit name, firmware version, computer type, computer software used 
and if possible a list of current parameter values for your unit (as shown in a DIS- 
PLAY listing). Be sure to include a return fax number and/or e-mail address. 


Returns to the factory for refund or exchange are strictly regulated. Any return 
for refund or exchange must be approved by the service department. 


Charges 


Consult the limited warranty policy in this manual for the service provisions of- 
fered by Kantronics at no charge. This warranty is considered to be in force only 
when the customer has submitted his completed warranty registration within 10 
days of purchase, and when the stipulations of the warranty have been met. 
Violations of warranty clauses will automatically void the warranty and service 
or repairs will be charged to the owner. 


Service outside the warranty will be charged at the cost of parts, labor, and return 
shipping. Units returned for service without a Return Authorization number will 
be subject to a minimum charge of 1/2 hour labor plus shipping and handling. 
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Contact the Service Department at 785-842-4476 (Hours: 1:00 p.m. - 5:00 p.m. 
Central Time, M-F) to obtain a Return Authorization number. Repaired units will 
be returned via UPS C.O.D. 


These C.O.D. charges can be avoided by including your VISA or MasterCard 
number with your unit to be repaired. Shipping and repair may then be charged. 


International Returns 


+ This section applies to international returns only, not to domestic returns. 


In case of unit problems, first contact the dealer from whom you purchased the 

product. If you must return a Kantronics product to us, please observe the steps 

outlined below. It will save both you, the customer, and Kantronics unnecessary 
difficulties and expense. 


All returns must be shipped to the factory at 1202 East 23rd Street, 
Lawrence, KS 66046 U.S.A. 


All expenses of returning items to Kantronics must be paid by you, 
including any duty/entry fees, whether the return is for warranty or 
non-watranty repair. 


Usually, the best way to return items to us is by mail. However, if you 
wish to use one of the courier services such as DHL, UPS Expedited, 
Federal Express, etc., be sure to use DOOR-TO-DOOR service. If you 
use one of these services, a commercial invoice may be required. Please 
check with your carrier before shipping. 


Include in the description of the items on the paperwork (whether postal 
or courier) the words: 


“U.S. GOODS RETURNED FOR REPAIR/REPLACEMENT.” 


An additional description of “Amateur radio peripheral equipment”, or 
“Data communications equipment”, would be helpful. It would also be 
helpful (but not required) to include the code number 9801.00.1035 
which tells U.S. Customs agents that the package contains “U.S. goods 
returned without improvement/enhancement’”. However, if the words 
“U.S. goods returned for repair/replacement” are on the paperwork, the 
number is not really necessary. 
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e Provide a value for customs purposes. This is usually the value of the 
item(s) in their current condition. A $0 value is not acceptable for U.S. 
Customs. 


e Inside the package, with the item(s), include: 


e a fax number and/or e-mail address (if available) in case we need to 
contact you 


e acorrect and full address for return 


e method of payment to be used for any charges (if MasterCard or 
VISA, include expiration date) 


e a brief description of the problem 


e areference to any conversations with the technical/sales staff about 
the problem 


e and the Return Authorization number assigned. 


e For warranty repairs, we will pay the shipping charges to return the 
item(s) to you via air parcel post. If you wish return by courier service, 
include your account number. To be eligible for repair under warranty, 
we must have a record that you sent your Warranty Registration card and 
proof of purchase to Kantronics, and the item(s) must still be within the 
warranty period at the time the return is authorized. 


e For non-warranty repairs, you must pay the return shipping charges. 
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Radio Frequency Interference Statement 


INFORMATION TO THE USER 


NOTE: This equipment has been tested and found to comply with the limits for a 
Class B digital Device, pursuant to Part 15 of the FCC Rules. These limits are de- 
signed to provide reasonable protection against harmful interference in a residen- 
tial installation. This equipment generates, uses and can radiate radio frequency 
energy and, if not installed and used in accordance with the instructions, may 
cause harmful interference to radio communications. However, there is no guar- 
antee that the interference will not occur in a particular installation. If this equip- 
ment does cause harmful interference to radio or television reception, which can 
be determined by turning the equipment off and on, the user is encouraged to try 
to correct the interference by one or more of the following measures: 


e Reorient or relocate the receiving antenna. 
e Increase the separation between the equipment and receiver. 


e Connect the equipment into an outlet on a circuit different from that to 
which the receiver is connected. 


e Consult the dealer or an experienced Radio/TV technician for help. 


The user is cautioned that any changes or modifications not expressly approved 
by the party responsible for compliance could void the user’s authority to operate 
the equipment. 


The user is also cautioned that any peripheral device installed with this equip- 
ment must be connected with a high-quality shielded cable to insure compliance 
with FCC limits. 
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EU Declaration of Conformity: “CE” 


NOTE: This equipment, Kantronics’ KPC-3 Plus, has been tested and found to 
comply with the essential emission and immunity requirements of the EMC Di- 
rective 89/336/EEC. The test results are on file at the corporate offices of 
Kantronics. 


Type of Equipment: Information Technology Equipment 
Class of Equipment: Class B 


RFI Suppression 


In moving to the world of digital communications via computers, a new dimen- 
sion of RFI may be encountered. In spite of the equipment manufacturers’ dili- 
gence, each new piece of electronic equipment will react differently in each 
separate environment. Every amateur station will have its own unique layout, 
equipment variation, and antenna installations. Experience has shown that these 
differences are related to the total RF environment, and may be causative factors 
in RFI induced problems. The suggestions given here may assist in resolving 
RFI problems you may encounter in your “unique” station. 


e Use shielded cable for all connections between equipment. 


e Make all interconnecting cables as short as practical. A balance should be 
maintained between cable length and equipment proximity. At times 
simply moving the video monitor one foot further from an interface or 
other device will solve a “screen hash” problem. 


e Antenna runs should be kept away from equipment control lines and/or 
interconnecting cables. If it is necessary for such lines to cross each other 
they should do so at 90 degree angles. 


e Ground leads should be as short as possible and go to a GOOD EARTH 
GROUND. 


e Interconnecting cables appearing to act as radiators or antennas should be 
looped through a toroid. Be certain toroids, if used, are designed for the 
frequency in use. 
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Welcome 


Welcome to the Kantronics KPC-3 Plus, your pathway to amateur radio packet 
communication. 


Please review this chapter before you install your KPC-3 Plus as part of your 
packet radio station. 


Overview of This “User’s Guide” Manual 
This user’s guide provides documentation on the KPC-3 Plus and packet radio, 
including the following: 
e What equipment you will need for your packet radio station. 
e §=6A brief introduction to packet radio. 


e Installing and configuring your KPC-3 Plus packet radio station and 
making your first connections. 


e Documentation for Pacterm, the PC terminal software shipped with the 
KPC-3 Plus. 


e Getting started using your KPC-3 Plus 
e Documentation for each mode of operation of your KPC-3 Plus. 
e A full “Command Reference”, documenting all KPC-3 Plus commands. 


e =Full details on KPC-3 Plus jumpers, a full parts list, and other technical 
specifications. 


Additional documentation and supporting material is available on the 
“Information and Program” disk that ships with the KPC-3 Plus. 
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Upgrade Summaries 


This section is for those who are upgrading to Version 8.2 of the KPC-3 Plus 


from the KPC-3, which is a device upgrade (i.e., both hardware and firmware), 
or fromVersion 7.0 of the KPC-3 Plus, which is a firmware upgrade. 


Differences Between the KPC-3 and the KPC-3 Plus 


The KPC-3 Plus is a new device, replacing the KPC-3, which introduces addi- 
tional firmware and hardware features not found in the KPC-3 and deletes several 
commands that were in the KPC-3. The KPC-3 has been discontinued; the 
KPC-3 Plus replaces it, featuring additional flexibility and expandability. 


Firmware Differences 


The KPC-3 Plus deletes several commands that were in the KPC-3 and adds 
several new commands: 


The PARITY command has been removed; the KPC-3 Plus now 
communicates on the RS232 port with 8 bits of data, no parity, and one 
stop bit (8,N,1). 


NUCR and NULF have been removed. Internally, they are set 
permanently to 0. 


LCSTREAM has been set ON permanently and the command removed. 


STATSHRT has been removed and its function has been combined with 
the STATUS command. STATUS always shows the ‘short’ status unless 
the LONG parameter is added to the STATUS command. 


The XMITLVL command has been added to set the audio (transmit) 
drive level of the modem. The drive level adjustment potentiometer is 
now digital, allowing for drive level adjustment via your keyboard 
(without having to open the case). 


The ANALOG and CTRL commands have been added to the 3 Plus to 
control the (new) two A/D inputs and two control line outputs 
respectively. 


User’s Guide 


12 KPC-3 Plus v 8.2 


Upgrade Summaries Introduction 


e A TELEMTRY command has been added to allow broadcasting the 
values of certain inputs on a regular basis. 


e A BREAK command has been added to allow exit from Convers or 
Transparent Mode; the user can now send an RS232 break sequence to 
return to Command Mode. 


e The BUDLIST and BUDCALLS commands have been combined into 
the BUDLIST command; the SUPLIST and SUPCALLS commands 
have also been combined into the SUPLIST command. In addition, 
BUDLIST and SUPLIST parameters have been expanded to allow more 
specific monitoring. 


e The CONLIST and LLIST commands now have their own list of 
callsigns instead of sharing with BUDLIST and SUPLIST as before. 


e The MHEADER command has been added to the monitor functions. 
When this command is off, only the data from monitored packets is 
shown. To avoid confusion, use of BUDLIST is recommended if the 
MHEADER command is off. 


e APBLIST command has been added for the PBBS. This command 
allows the owner to add family members who are also hams to the list of 
‘owners’. If PBLIST is ON, the mail-status LED will blink when mail is 
available for anyone on the list and the List-mine, Read-mine, and 
Kill-mine commands will operate on this list. 


e The MHCLEAR, NDHCLEAR, and PHCLEAR commands have been 
removed; the clearing function is now a parameter of the MHEARD, 
NDHEARD, and PHEARD commands. 


e The FULLDUP command has been expanded to include a LOOPBACK 
parameter. The original KPC-3 receive circuit was still active while 
transmitting when FULLDUP was OFF. Now when FULLDUP is off, 
the receive circuit is inactive while transmitting. When FULLDUP is 
LOOPBACK, the receive circuit is active while transmitting. 


e MODEM has been added to the INTFACE command. 
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The CONPERM command has been added which allows an AX.25 
connection to be permanently connected, even after a reset or power 
failure. 


The function of the XCD pin has changed. If CD is set to EXTERNAL, 
the pin will function as before as an indicator of channel activity and 
valid modem signals on the received audio line. If CD is INTERNAL or 
SOFTWARE, the XCD pin functions as an additional transmit inhibit. 


Hardware Differences 


There are several major and a number of minors hardware differences between 
the KPC-3 and the KPC-3 Plus: 


The audio drive pot is now digital, rather than analog, controlled by 
either the XMITLVL or CAL command. See the command reference for 
details. 


Two A/D inputs, at 8 bits resolution, and two control line outputs have 
been added. The “DC” A/D inputs are read using the ANALOG 
command and the output control lines are held, pulsed, or toggled using 
the CTRL command. 


Space has been retained within the case for a 9 volt battery. 


Sixteen “jumpers” have been placed on the board to allow for 
configuration flexibility. For example, the unit may be set up for 
external, battery, or both operation. See the listing of jumpers and their 
functions in Appendix B. 


Differences Between Version 7.0 and Version 8.2 


Version 8.2 introduces four new commands for use with GPS (and APRS) activi- 
ties: UIDIGI, UIFLOOD, UITRACE, and UIDWAIT. These commands may be 
useful for other activities too. These commands are explained in the “Advanced 
GPS (or APRS) Digipeating” section of the Modes of Operation chapter and in 
the Command Reference. 
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Major Uses of Your KPC-3 Plus 


By adding the KPC-3 Plus and a computer to your ham radio station, you can 
send and receive packets of digital information. This allows you to do the follow- 
ing: 


® use computers to carry on real-time digital conversations between 
stations 


e send, receive, store and forward mail using a personal mailbox inside the 
KPC-3 Plus 


e send and receive mail using a community bulletin board 
e send and receive files 


e get and re-transmit location data from the Global Position System 
devices 


e serve as a digipeater for other stations 


e serve as a network node point for other stations, using KA-NODE and/or 
the optional K-Net feature 


And much more. 


Package Contents 


Check to see that you have the items listed below (later you will see how these 
items are used in your system): 


e = KPC-3 Plus unit 
e parts to use in assembling cabling 


e Male DB-9 connector for radio port 


e 3 foot piece of 5-conductor shielded cable to connect the KPC-3 Plus 
to your radio 


e Mini-plug cable for radio receive audio 


e 2.1 mm power connector 
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an “Information and Program disk” (3.5", DS/HD 1.44MB, formatted for 
PC (IBM) compatible computers), which includes a PC terminal 
program. 


Registration card 
Warranty card 


and, of course, this ‘“User’s Guide” manual 


IMPORTANT: Check your warranty card for the serial number and EPROM ver- 
sion of your KPC-3 Plus and record this information on the inside cover of this 
manual for future reference. 


Additional Parts For Your Packet Radio Station 


In addition to your KPC-3 Plus unit, you will need the following parts to set up 
your packet radio station: 


An FM transceiver 

A microphone (Mic) or accessory jack connector for your radio 

A computer (or other RS-232 terminal device) 

A serial modem cable, used to connect the KPC-3 Plus to your computer 
A 12 Vdc power supply or power adaptor 


(optionally) 9-volt battery and battery clip (not supplied, you must 
install) 
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Our Assumptions About You 


We assume that you are familiar with the following or that you can get help on 
these topics if necessary: 


e general familiarity with your radio equipment and it’s intended uses 


e basic use of IBM compatible computers and DOS, including copying 
disks and files, working with directories, and identifying and using the 
serial (COM) ports on your computer 


e basic electronics needed if you are going to build or upgrade hardware 
yourself, (e.g., making cables) 


Documentation Conventions 


The following conventions are used in the KPC-3 Plus documentation: 


To indicate a particular key, the name of the key is given in capitals. For exam- 
ple, press the ENTER key. 


Sometimes you need to hold down one key on the computer while pressing an- 
other key. This is indicated by giving the name of the first key, then a plus “+”, 
then the name of the second key. For example, “Ctrl+C” means “press the key la- 
beled *CTRL" or “Ctrl” (i.e., the “control” key) and, while continuing to hold it 
down, press the “C” key. Multiple-key combinations that generate a single char- 
acter are shown in angle brackets, like this: <Ctrl+C>. 


Conventions for the KPC-3 Plus commands are covered in the “Command Ref- 
erence” section of this manual. 
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Overview of Packet Radio 


This section gives a brief overview of packet radio, for those who are new to 
packet radio and those who want to review the topic. 


Topics covered are: 
e The three basic components of a packet radio station 
e Sending a message from one station to another 
e Details about packets 
e A brief discussion of protocols 


e An overview of the insides of the KPC-3 Plus 


If you are already familiar with packet radio, you may wish to skip the rest of this 
chapter, or give it a quick review. 


Packet radio gives you the ability to send essentially error-free digital communi- 
cations to other packet radio stations. As a sender or receiver, you see just the 
messages, or files, being sent and received, but there is much going on beneath 
the surface. You will get more out of packet radio, and have an easier time get- 
ting started, if you have at least a basic understanding of what is involved in 
packet radio communication. 


+ Do not be concerned here with how to do things — that comes later. 


Three Basic Components of a Packet Radio Station 


A packet radio station has three basic parts: 
e a transceiver, with an antenna, 


e adevice called a TNC (i.e., Terminal Node Controller), which is a 
combination modem and special-purpose micro-computer, and 


e ageneral purpose computer (or a terminal). 
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Antenna 


KPC-3 Plus 


TNC -— Computer 
(Term inal-Node Controller) 


Transceiver 


© Copyright 1997 by Kantronics Co., | 


The three parts of a packet radio station work together as follows: 


e The transceiver: (1) sends and receives radio signals to and from your 
antenna and (2) passes audio signals back and forth between itself and 
the TNC. 


e The TNC (Terminal Node Controller): (1) translates audio signals into 
digital information and vice versa, (2) performs a number of control and 
information storage functions, and (3) communicates digitally with your 
computer. 


e The computer communicates digitally with the TNC, so you can: (1) 
view messages received from the transceiver or stored in a mailbox (i.e., 
PBBS), (2) use the computer to send data to, and receive data from, 
other stations, via the TNC and your transceiver, and (3) control the 
operation of the TNC. 


Sending a Message to Another Station 


A quick way to see the basic components of packet radio in action is to follow a 
simple message as it goes from one station to another, via an intermediate station. 


Let’s assume that an originating station, WOXI, wants to send the message 
“HELLO” to a destination station, KBONYK. Also, assume that WOXI knows 
that his signal might not reach KBONYK’s station directly, but that it can be 
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picked up and repeated by an intermediate station, NOGRG, and then received by 


KBONYK. 


The following are the basic steps of a station-to-station packet communication, as 
seen from the point of view of the message, “HELLO,” sent from source station 
WOXI to destination station KBONYK, through intermediate station NOGRG. 
Step 1 is one-time configuration task, Steps 2-3 establish a connection between 
stations, and Steps 4-13 follow the “HELLO” message from the time it is created 
by WOXI to when it is read by KBONYK. 


Step 1. 


Step 2. 


Before this message can be transmitted from a source 
station to a destination station, via an intermediate sta- 
tion, all the stations involved have to have callsigns, 
which are used by the TNCs involved to identify and 
process information (e.g., source, destination, and rout- 
ing of information). 


So we start by assuming each operator involved in this 
example has already performed this one-time configura- 
tion task, creating the callsigns given above. Stations are 
identified by reference to their callsigns. Note that a 
callsign can be for a TNC (e.g., KPC-3 Plus) or for a 
Personal Bulletin Board System (PBBS) “mailbox” that 
resides in RAM inside the TNC. 


This communication begins when the operator of station 
WOXI turns on his computer, TNC (e.g., a KPC-3 Plus), 
and transceiver of his station and uses a computer soft- 
ware program to tell the TNC that he wants to establish a 
line of communication, called a “connection,” with a 
“destination” station KBONYK using an intermediate 
station NOGRG as a repeater station to carry the infor- 
mation beyond the range of the originating station and 
into the range of the destination station. 
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Step 3. 


Step 4. 


Step 5. 


Step 6. 


Introduction 


The “connect” command with address given to the TNC 
causes the TNC to formulate a “request to connect” mes- 
sage that is sent from WOXI. If this message is detected 
by the specified intermediate station (i.e., NOGRG), re- 
peated, and then detected by the destination station 

(i.e, KBONYK), a connection may be established. 


To confirm a connection, the destination station automat- 
ically sends a special message back though the reverse 
path, to the originating TNC. 


When this “confirmation of connection” is processed by 
WOXI’s TNC, the TNC assumes that the operator wants 
to begin sending messages. So the TNC: (1) puts a mes- 
sage on the computer monitor confirming that W@XI is 
now connected, through intermediate station NOGRG, to 
KBONYK, (2) turns ON the “connected” indicator on 
the TNC, which stays ON as long as the connection is in 
effect, and (3) switches itself from taking commands 
from the computer (i.e., TNC in “command mode’) to 
serving as a message-processor, sending and receiving 
messages to and from the connected stations (i.e., TNC 
in “conversation mode”). 


Now that WO@XI is in “conversation” mode, the operator 
types in the message, “HELLO”, and presses the 
ENTER key on the computer to indicate the end of the 
message and the beginning of the message’s journey. 


The computer sends the message, “HELLO,” to the TNC 
for processing. 


The TNC receives the message, “HELLO”, and takes 
charge of the situation, performing a number of complex 
operations: it uses the “connection” information about 
where the message is to go and the path it is to take and 
combines this with the message itself to assemble a 
“packet” of digital information for transmission from the 
transceiver. 
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Step 8. 


Step 9. 


Step 10. 


Step 11. 


Overview of Packet Radio 


The details of what is in the packet and how it is orga- 
nized are fully defined by agreed-upon standards, so any 
machine that knows the “rules” can make use of the in- 
formation. The standard for amateur packet radio at this 
time is AX.25, so let’s assume the packet assembled in 
the TNC is an AX.25 packet . 


Technical note: All amateur radio packets use the AX.25 
standard, but it is possible to use another standard or pro- 
tocol (e.g., TCP/IP) “on top” of AX.25, in which case the 
packet is referred to by the name of the highest-level pro- 
tocol. 


After the TNC assembles the “HELLO” message into a 
packet of digital information in the TNC, it passes the 
packet on to a modem, which is also in the TNC, which 
transforms the information into a series of audio signals 
for serial transmission to station WOXI’s transceiver. 


The TNC orders the transceiver to send a message (1.e., 
keys push-to-talk) and then sends the audio version of 
the “packet” through the radio port of the TNC, up a ca- 
ble to the microphone connector on station WOXI’s 
transceiver, and to the transmitter. 


The packet is transmitted by WO@XI’s transceiver as a 
burst of radio-frequency signals. 


The “HELLO” packet, including address information 
(i.e., to, from, via) and other control information, is now 
on the air, where it may be correctly interpreted by all 
appropriately configured (i.e., AX.25 packet) stations 
that receive the signal. 


KB@ONYK is on the air and is running AX.25 packet, but 
it is too far away from W@XI to pick up the signal, so 
does not get the message as it is sent from WOXI. 
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Introduction 


As we know from the “connection,” already established, 
intermediate station NOGRG, an AX.25 packet radio sta- 
tion, is on the air, and is close enough to receive the ra- 
dio burst sent by WO@XI. It receives the burst of radio 
signals from W@XI and passes the audio signals on to its 
TNC for processing. The TNC (e.g., a KPC-3 Plus) 
transforms the signal from audio to digital, analyzes the 
series of 1’s and 0’s in the incoming bit-stream, and 
identifies the burst as an AX.25 packet of information 
containing the message, “HELLO.” 


Also, and most significantly, NOGRG registers that the 
packet designates NOGRG as the first (and only) inter- 
mediate station on a path between a source, WOXI, and 
a destination, KBONYK. As a fully-functioning AX.25 
packet station, NOGRG knows what to do: it sends the 
message back out over the air (i.e., digipeats it), where it 
may or may not be received by its intended destination, 
KBONYK. Before doing so, it marked its call in the 
packet to indicate to others that it had seen the packet 
and had sent it on its way. 


Note: Since a “connection” has been established, we ex- 
pect the message to get through, but each packet is pro- 
cessed separately, and each must make it on its own. 


As we know from the “connection,” already established, 
KBONYK, an AX.25 packet radio station, is on the air, 
close enough to receive the RF burst sent by NOGRG, 
and currently set to display messages on a computer 
screen. So the “HELLO” message re-transmitted by 
N@OGRG arrives at KBO@NYK’s TNC (e.g., a KPC-3 
Plus), where it is processed and recognized as an AX.25 
packet addressed to itself. Then KBONYK’s TNC sends 
the message, “HELLO,” to the computer screen for 
KBONYK to read. At the same time, KBO@NYK’s TNC 
creates an acknowledgment packet to send back to 
WOXI’s TNC, reversing the address path it found in the 
“HELLO” packet. When KBONYK’s TNC detects that 
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the radio channel is clear, it keys the transmitter and 
sends the packet back over the air. 


Step 14. N@GRG’s TNC now recognizes another packet which 
has its callsign in the address path, requesting it to be 
digipeated. NOGRG’s TNC does so as soon as it can. 


Step 15. WOXI’s TNC now hears a packet addressed to it. Since 
the digipeated packet originally came from KBONYK, 
to whom he is connected, and since the packet contains 
an acknowledgment for data that he had recently sent, 
W@XI’s TNC can rest easy knowing that the data he 
sent was properly received. 


This concludes our close-up look at a single packet communication event, show- 
ing how the various parts of packet radio work with each other. To simplify and 
focus this example, various details and possible complications were ignored, but 
this still shows the basic steps involved in establishing a connection and sending 
the message “HELLO” from one person/station to another person/station. 


This example covers one of many uses of packet radio. As covered in other sec- 
tions of this manual, there are many ways to communicate with other stations. 


Now that you have followed one particular message from one station to another, 
it is useful to learn about the “packets” in packet radio. 


Packets: Dividing Messages into Segments 


An efficient way to send a message from one place to another is to break the in- 
formation into small segments, called packets or frames, and send each packet 
separately. 


Note: The correct technical term is “data frame’, not “packet” or “frame,” but we 
will use the term “packet,” since that is familiar to most people and is common in 
the field. 
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Your packet radio station automatically divides your communication 

(e.g., a message or file) into small segments (see the PACLEN command for de- 
tails) and puts each segment into it’s own “packet.”. Each packet includes infor- 
mation used for addressing and error correction. 


Unconnected Packets 


Packets do not need to be addressed to any particular station. Packets transmitted 
without any established connection between sender and receiver are “uncon- 
nected” packets. “Unconnected” packets are just sent out without any 
back-and-forth coordination with any receiving station. Stations receiving these 
packets can check to see if the packets are correct (i.e., the same bit pattern is re- 
ceived as when they were sent), but they cannot request any retransmission of 
faulty packets. Nor can they request re-transmission of any packets in a series 
that are not received at all. This is because “unconnected” packets do not include 
sequence information that could be used to track them in order and also because a 
TNC sending or receiving “unconnected” packets is not set up to do any commu- 
nicating about the success or failure of its packet transmissions. 


+ Note: Packets sent as “unconnected” are also called UNPROTO (non-protocol), 
because the sender expects no response from the receiving station. 


Connected Packets 


Packet radio communication is often done between two stations that are con- 
nected together. “Connected” communication using packet radio assures trans- 
mission with virtually 100% accuracy by having the sender and receiver follow a 
set of rules for communicating. These rules are specified in the AX.25 protocol. 


The following is an overview of what happens during a packet radio communica- 
tion between two connected stations. 


After a connection has been established between two stations, information 
Packets are transmitted one-by-one (or in small batches), with a sequence number 
as part of each packet, from the sending station to the receiving station. As the 
communication proceeds, the receiving station keeps track of which packets it 
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has received error-free (as determined by using the check-sum that is part of each 
packet) and uses this to tell the sending station what packet(s) to send next. 


Using these rules of communication, a packet radio connection between a sender 
and a receiver provides virtually error-free transmission of information, until the 
communication is ended by the parties, or until the sender “times out” after trying 
a number of times to get feedback and not succeeding. 


+ Hint: In most cases, communication by packet radio is like mail, not the tele- 
phone, in that it is not done in real-time, but via messages that are routed from 
one station, or “node,” to another. 


How a Packet is Organized 


Your packet radio station takes care of all the details of working with packets, so 
you do not need to see the “inside” of packets. But it is useful to have at least a 
basic idea of how they are organized. 


All amateur radio packets (also called “frames”’) are defined by the AX.25 proto- 
col, which is discussed in the next section. Packets used to carry messages, or 
chunks of messages, as in the “HELLO” example, are called “information pack- 
ets.” The following diagram shows the basic building blocks of “connected in- 
formation” packets used in amateur packet radio: 
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Single character, for 
‘beginning of packet" 


Destination station, 
Source station, and 
up to 8 intermediate stations 


Kind of packet, 
packetnumber, 
and othercontrol 
information 


Protocol ID: Code 
for protocol used 
for this packet 
(e.g., AX.25 or 
TCP/IP) 


PID 


(string of bits) 


Data: 

Information or message 
being sent "inside" this 
packet (1 to 256 bytes, 
which may include 
protocol-related data) 


Data 


Introduction 


Single character, for 
‘end of packet" 


Code derived 
from this packet, 
used to check 
forenors in 
transmission 
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Kinds of Packets 


As shown in the above diagram, the “control” field in an AX.25 packet includes a 
code telling what kind of packet the current packet is. In addition to connected 
information packets, the AX.25 protocol also defines two other kinds of packets, 
each of which is nearly identical in structure to the connected information packet: 
control packets (of which there are several kinds) and unnumbered packets. To 
learn more about these, see the documentation for the KPC-3 Plus’s MCOM 


command. 
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As noted at the beginning of this section, the organization of amateur radio pack- 
ets is defined by the AX.25 protocol. Now it is useful to give a brief discussion of 
this protocol, and another that fits “within” it. 


Protocols: Rules for Working Together 


Packet radio, like any communication, is only possible if all parties involved 
(i.e., sender, receiver, and intermediate points on the route between them) agree 
on the rules for organizing information and the rules for dealing with all steps of 
the transmission. These rules are called “protocols,” or standards. 


AX.25 


The defacto standard protocol for amateur packet radio communication is 
AX.25 (level 2, version 2). For details on AX.25, see the ARRL publication, 
AX.25 Amateur Packet-Radio Link-Layer Protocol. 


+ Hint: You can set the KPC-3 Plus to use an earlier protocol, AX.25 (level 2, ver- 
sion 1) 


Alternatives to AX.25 
TCP/IP and the KISS protocol : The TCP/IP (Transmission Control Proto- 


col/Internet Protocol) suite of protocols require functionality not found in native 
AX.25 packets, so Phil Karn KA9Q defined a protocol called KISS that imple- 
ments TCP/IP functionality for amateur radio. For further information on KISS 
see the KISS Mode section of the “Modes of Operation” chapter. 


XKISS is an extension of the KISS protocol, defined by John Wiseman G8BPQ. 
For further information on XKISS, see the XKISS Mode section of the “Modes 
of Operation” chapter. 
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Inside a TNC — the KPC-3 Plus 


To better understand the workings of your packet radio station, it is helpful to 
have an overview of the major components of the TNC device at the center of 
your station. 


In the early days of packet radio, TNC’s consisted primarily of a modem for 
communicating with a transceiver and a special-purpose microprocessor called a 
PAD (i.e., packet assembler/disassembler), used to process packets of informa- 
tion and communicate with a computer or terminal. 


As packet radio has developed, more and more features have been added, such as 
memory and software dedicated to a “Personal Bulletin Board System” within 
the TNC. The following diagram shows the most important internal components 
of a TNC (the KPC-3 Plus). 


+ The diagram is not to scale. For a detailed example, see the parts list and layout 
diagram for the KPC-3 Plus in the appendices of this manual. 


Note: Other TNC’s may have different features than the KPC-3 Plus — for exam- 
ple, the ability to operate two radios at once. 
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This concludes the introduction to packet radio. The next chapter guides you 
through the steps of installing your KPC-3 Plus. 
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This chapter covers the hardware side of setting up your packet radio station, and 
refers where necessary to the following chapter on “Pacterm’’, for the steps in- 
volved in software configuration. 


The goal of this chapter is to guide you as quickly as possible through the steps 
of setting up your packet radio station. 


The major steps involved in installing (i.e., connecting the parts) your packet ra- 
dio station are as follows: 


® connect your KPC-3 Plus to a power source and confirm that the unit 
powers on when it should, 


e connect the “Computer” port on the KPC-3 Plus to a serial port on your 
computer, install terminal communication software in the computer, and 
configure the software and the KPC-3 Plus so digital information can be 
sent back and forth between the KPC-3 Plus and the serial port on the 
computer, 


e connect the “Radio” port on your KPC-3 Plus to your transceiver and 
adjust the volume of the transceiver, so the KPC-3 Plus can receive 
signals from the transceiver for processing and the KPC-3 Plus can send 
signals to the transceiver for transmission, 


e (optionally) use the “Computer” port on the KPC-3 Plus to connect your 
KPC-3 Plus to a GPS device, so the KPC-3 Plus and the GPS device can 
send digital information back and forth. 


After you have followed the “hardware installation” steps in this chapter and the 
“software installation and configuration” steps in the “Pacterm” chapter, you will 
be ready to move on to the “Getting Started” and “Modes of Operation” chapters. 


To show you where you are heading with the step-by-step configuration covered 
below, we start with a brief section on equipment needs for your station and an 
overview diagram that shows how the parts of your station will be connected 
when you are ready to begin using it. 
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The Major Components of Your Station 


This section describes the basic components needed for your packet radio station 
and the connections between components that will be involved in the installation 
of your station. 


The KPC-3 Plus 


Your KPC-3 Plus is going to be at the center of your packet radio station, so set- 
ting up your station involves connecting other units to your KPC-3 Plus. 


As shown below, the back of the unit has connectors to connect the KPC-3 Plus 
to your transceiver, your computer (or a GPS device), and a power source: 


Back Panel 


|S SSC C8 83008 i 


ei) 


Radio Port Computer Port Power Jack 


DE-9 DB-25 2.1 mm 
(female) (feaaale ) 


Note: All Kantronics TNCs can operate without the computer being connected, 
once they have been configured. For example, you can receive and store messages 
in the personal mailbox inside the KPC-3 Plus without using your computer. And 
your KPC-3 Plus can serve as a relay station for other stations without your com- 
puter being connected. This independence from the computer is possible because 
the TNC contains the intelligence necessary to carry out these functions, once it is 
appropriately configured and attached to a transceiver. 
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The Transceiver 


Your KPC-3 Plus will operate with most FM transceivers. 


There are currently hundreds of models of FM transceivers. You will need to re- 
fer to the documentation for your transceiver to determine how it must be 
connected to external devices, such as the KPC-3 Plus. 


Specifically, you will need to know: 
e what type of microphone connector to use with your transceiver, and 


e which pins connect to which in the cabling between the KPC-3 Plus and 
your transceiver’s microphone 


Wiring diagrams for some common transceivers are included later in this chapter 
for your assistance. 


The Computer 


Your KPC-3 Plus can work with any computer that can communicate with it 
through a standard RS-232C serial modem port. 


Technical note: You need to be sure the wiring is as shown in the installation sec- 


tion below. You may, of course, make your own cable; make sure it is correctly wired 
and shielded. 


To use your KPC-3 Plus with “Pacterm’, the terminal communication software 
that ships with the KPC-3 Plus (on the 3.5 in. “Information and Program” disk) 
you need the following: 


e Computer: A PC (IBM) compatible, XT or above 

e Operating System: MS-DOS or PC-DOS version 3.3 or higher 
e RAM (Random Access Memory): A minimum of 384 K 

e Disk drives: A 3.5 ” High Density (1.44MB) floppy drive 


e Hard drive: (optional) You do not need to use a hard drive with the 
“Information and program” disk or other communication program. If you 
want to gain speed and convenience by using your hard drive, be sure 
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you have enough space available to store the program used to 
communicate with the KPC-3 Plus and/or space to store the files you 
want to use from the “Information and Program” disk. 


e Serial (COM) Port: The KPC-3 Plus can communicate with the 
computer using any serial (COM) port. The software used in the initial 
installation of your system (i.e., Pacterm) uses COM2 by default or 
COM1 if you wish. If you use other communication software, you can 
use any COM port that your communication software supports. 


Note: If you are not sure how to determine what serial (COM) ports you 
have, or how to make COM1 or COM2 available for use with the KPC-3 
Plus, see your computer documentation and/or dealer. 


e Communication Software: A terminal communication program, to 
allow your computer to communicate with the KPC-3 Plus. Pacterm, 
which is a basic-level terminal communication program, is included on 
the “Information and Program Disk.” This program is used in the initial 
installation and configuration of your KPC-3 Plus packet station. After 
you get up and running, there are many communication programs you 
could use with the KPC-3 Plus. For example, Kantronics’ Host Master 
II+ offers significantly more functionality than does the start-up 
program. 


Note: Users of Windows 3.1 or above have another alternative: The Win- 
dows Accessories includes a basic terminal program, called TERMINAL 
that may be used to run the KPC-3 Plus. 
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The Serial Port on Your Computer 


You will be using a standard (RS-232C) modem cable (or making a cable with 
the same wiring) to connect your KPC-3 Plus to a serial (COM) port on your 
computer. The connector needed at the computer-end of the modem cable has to 
fit the connector on your computer’s serial (COM) port. Therefore, you will need 
to know the following: 


1. Is yourcomputers serial (COM) port DB-9) or ‘DB-25)? 


‘ Deo po 


The comoputerend of vourRS-232 cable must have the 
Back Panel 


_(eoeee) 


= eel ai 
eee) 


Radlo Port Computer Port Power Jack 
DE-9 DB-25 2.1 mm 
i — i wéaielc) 


to connect to the ‘computers male serial (COM). port 


+ Hint: Since, the KPC-3 Plus’s “Computer” port has a female DB-25 connector, 
the KPC-3 Plus end of your modem cable must have a male DB-25 connector. 


You also will need to be sure your KPC-3 Plus to computer cable is correctly 
wired. This topic is covered when we get to the actual installation of the cable. 


Technical note: To use your KPC-3 Plus with a non-PC compatible, use a serial 
communication program and a serial modem cable (i.e., RS-232C cable). You can 
get help from your computer dealer, users group and members of the amateur radio 
community. When talking with computer dealers or others who may not be famil- 
iar with packet radio, refer to your KPC-3 Plus as an “external modem,” not as a 
“TNC,” a less familiar term. 
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GPS Device (Optional) 


The KPC-3 Plus works with Global Positioning System (GPS) devices that (1) 
support the NMEA-0183 standard, and (2) have a dataport through which they 
communicate. The GPS device connects to the KPC-3 Plus through the KPC-3 
Plus’s serial (““computer’’) port. 


Note: The GPS data port must be RS-232 compatible to mate with the KPC-3 Plus. 


How the Parts of Your Station are Connected 


The following diagram shows how the components of your KPC-3 Plus packet 
radio station will be connected and the kinds of connectors that will be used. 


KPC-3 Plus 


(connections on back) 


Radio 
(Tra nsc eiver) Computer (orG PS) 
DB-9 (female) DB-25 (female) 


Shielded 
RS-232 
cable 


2.1mm 
power jack 
and stranded 
2-conductor wire 


5-conductor 
shielded 
cable 


Bench Power Supply (12 Vdv) 


Moulded 
mini-p lug 
cable 

and jack 


Mic connector 


Powercube 
Microphone Serial (COM) port Power adaptor 
DB-9 or DB-25 (120 Vacih2 Vie my “2° 
Transceiver (male) with cable 


Speaker assembly) 


jack Computer 
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As you assemble your station, you may wish to refer to this diagram. 
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With this overview, we are now ready for step-by-step instructions for installing 
your station, which we will do in the following order: 


e the three different ways you can power the KPC-3 Plus. 
e the RS-232 connection between your KPC-3 Plus and your computer. 


e the cable assembly connecting your KPC-3 Plus to both the speaker jack 
and the microphone of your transceiver. 


e (optional) the connection between the computer port on your KPC-3 Plus 
and a GPS device. 


As we go through the steps of setting up your station, we will shift from hard- 
ware to software issues and back, since your station needs to be set up both in 
terms of hardware and software. 


Connect Your KPC-3 Plus to a Power Source 


As illustrated on the right side of the station cabling diagram on page 36, there 
are three ways to supply power to your KPC-3 Plus. 


e You may use external power by connecting the KPC-3 Plus to a 12 volt 
dc source on your bench. 


e You may use external power by connecting the KPC-3 Plus to a 120Vac 
power source using a 12 volt de adaptor. 


e You may use internal power by installing a 9 volt battery inside the 
KPC-3 Plus (as explained below, before doing this you need to install a 
battery clip (pig tail) inside your KPC-3 Plus). 


+ See Appendix E for the allowed range of voltage inputs. 


The steps needed for each way to supply power to the KPC-3 Plus are given be- 
low, along with detailed specification for each part needed. Of course, the parts 
you need depend on which option(s) you use. 


+ The KPC-3 Plus ships with LEDs ON, so the Power indicator (LED) will turn 
ON when power is ON. If the LED value has been switched to OFF, the Power 
LED will just blink once, briefly, when power is applied. 
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External Power from Your Bench (12 Volt dc) 


Here, you will use a 2.1 mm power jack and 18-22 gauge stranded 2-conductor 
cable to connect to a 12 Vdc power supply on your bench. The steps are: 


Step 1. Build a cable by attaching the supplied 2.1 mm 
power jack to a user-supplied 18-22 gauge stranded 
2-conductor cable — connecting the center of the jack to 
the positive terminal of the power supply and the shell of 
the power jack to the negative terminal of the power 


supply, 
Step 2. 


(1)Turn OFF all power, (2) attach one end of the 
bench-power cable to a 12Vdc power source on your 
bench, and (3) plug the 2.1 mm power jack into the 
“Power” connector of the KPC-3 Plus, 


Step 3. (1) Turn ON the power supply, (2) press the power 
switch on the front panel of the KPC-3 Plus to turn your 
KPC-3 Plus ON, (3) confirm that the power indicator 
next to the power switch goes on, and then (4) press the 
KPC-3 Plus’s power switch again to turn the power OFF. 


+ Ifthe power indicator (LED) does not go on as expected, check to be sure the 
wiring is correct. If you have checked the wiring carefully and the power indica- 
tor still does not go on as expected, the unit may be defective, so you should 
check with your dealer. 


Caution: Do not exceed the power specifications for the KPC-3 Plus (see specifi- 


cations). If you elect to install a fuse in the positive lead, do not use a fuse of 
greater than 200 ma. 


External Power Transformed from 120 Vac Line Voltage 


You can use external power from a 120Vac power source after transforming the 
external power to 12Vdc (using a class 2 transformer: input 120 Vac 60 Hz 6W; 
nominal output 12Vdc 300mA). 
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The steps are: 


Step 1-A. You may order from Kantronics, as an option, a 
Kantronics 120 Vac to 12Vdc 300mA power adapter, or 


Step 1-B. You may purchase the needed 120 Vac to 12Vdc 300mA 
power adapter from a third party , 


Step 2. Connect the 2.1 mm connector on the assembly to the 
power connector of the KPC-3 Plus and plug the power 
adaptor into the 120Vac power source (being sure that 
the center is positive), 


Step 3. Press the power switch on the front panel of the KPC-3 
Plus to turn your KPC-3 Plus ON, confirm that the 
power indicator next to the power switch goes on, and 
then press the power switch again to turn the power OFF. 


+ Ifthe power indicator (LED) does not go on as expected, the unit may be defec- 
tive, so you should check with your dealer. 


Internal Power, from a Battery. 


For activities such as field day and back-packing, you can also install an internal 
Ov battery for power, after installing a battery clip on the printed circuit board of 
the KPC-3 Plus. 


Note: Before installing a 9 volt battery inside the KPC-3 Plus, you need to install a 
battery clip (pig tail) and configure jumpers J1 and J2. First, purchase a 9 volt bat- 
tery clip (e.g., Radio Shack’s heavy-duty 9V snap connector, part number 270-324). 
Second, solder the clip leads to the battery pads on the printed circuit board (pcb). 
The pads are labeled “+BATT-” and are located in the corner of the PCB near the 
power connector. Make sure you solder the positive lead of the battery clip to the 
“+” nad, and be careful not to damage any other connections on the pcb (use a low 
watt iron). Third, set jumpers J1 and J2; defaults are J! OFF (jumper on one leg 
only) and J2 ON (jumper on both legs). In this position, the battery will power the 
TNC and will be cut off (by jack P3) if an external power supply is attached. If you 
desire the battery to take over, i.e. run the unit, in case the external power supply is 
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plugged in but fails (or not turned on), then set J1 ON and J2 OFF. In this configura- 
tion, whichever supply has the higher voltage (battery or external supply) will 


power the TNC. 


To use a 9 volt battery for power, install the battery as follows: 


Step 1. 


Step 2. 


Step 3. 
Step 4. 


Step 5. 


Open the KPC-3 Plus case 


Confirm that a battery connector (pig tail, snap connec- 
tor) has been installed or install one, as described above, 
if needed. If there is a protective clip over the battery 
connector, remove it. 


Attach a 9 volt battery 

Close the case 

Press the power switch on the front panel of the KPC-3 
Plus to turn your KPC-3 Plus ON, confirm that the 


power indicator next to the power switch goes on, and 
then press the power switch again to turn the power OFF. 


+ Ifthe power indicator (LED) does not go on as expected, the unit may be defec- 
tive, so you should check with your dealer. 


This-cenchides the instalation of power te-yeur KPC-3 Phis_The next tepicis 
connecting your KPC-3 Plus to your computer. 
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Connect your KPC-3 Plus to Your Computer 


Your KPC-3 Plus and your computer communicate with each other via a serial 
communication cable connecting the KPC-3 Plus’s “Computer” port and a serial 
(COM) port on your computer. This connection is shown in the diagram on 
page 36. 


Your Serial Communication Cable 


The serial cable needed to connect your KPC-3 Plus to your computer (a standard 
off-the-shelf, RS-232 modem cable) is not supplied with the KPC-3 Plus. You 
will need to purchase one, or construct one. 


Note: You may construct your own cable, using wiring instructions given below. 


The two options, purchasing your cable or making it, are covered next. 


Purchase Your Serial Cable 


To purchase your cable (from your local amateur radio dealer or computer 
dealer): 


e specify that you need a standard serial modem cable (RS-232C), with 
high quality shielding, of whatever length is appropriate, and at least 9 
wires connected, 


e specify that one connector be a male DB-25 connector (to connect to 
your KPC-3 Plus’s female “Computer” port) and the other connector be a 
female DB-9 or DB-25 connector (depending upon whether your 
computer’s serial (COM) port has a male DB-9 or DB-25 connector), 


Make Your Serial Cable 


This section is for those making their own cable instead of purchasing one. 


We assume that if you are making their own cable you are familiar with the pro- 
cess and just need to know: (1) what parts are needed, and (2) how the parts are 
connected. 
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Parts needed: 


e amale DB-25 connector, to connect to the KPC-3 Plus’s (female) 
“Computer” port, 


e either a female DB-9 or a female DB-25 connector, depending on the 
connector on your computer’s serial (COM) port, to connect to the 
computer’s (male) serial (COM) port, 


e an appropriate length of high quality shielded cable with 5 or more wires, 


e as shown below, if you are using a DB-9 connector, either 5 or 8 wires 
can be connected and any other wires are unused, 


e as shown below, if you are using a DB-25 connector, either 5 or 9 
wires can be connected and any other wires are unused. 


Wiring instructions: 


+  Pacterm, the communication software shipped with the KPC-3 Plus, needs the 5 
wire connections shown below. Some third-party software does not use hardware 
flow contol and therefore does not need the RTS and CTS wires shown below. 


For details on preparing your cable wiring, use the chart below that is appropriate 
for your configuration. In each case, there is a listing of which KPC-3 Plus 
(“Computer” port) pin needs to be connected to which pin on the computer’s 
serial (COM) port. The wiring depends upon whether your computer has a 25 pin 
connector or a 9 pin connector, and on how many wires are in the cable (you only 
need 5 wires connected for KPC-3 Plus operations, but you may connect more 
wires to use the cable for other purposes). See page 257 for a diagram showing 
pin numbers on a DB-25 connectors. 


CASE 1-A: Wiring if computer has a 25 pin connector and the cable has 5 wires: 


KPC-3 Plus_ <——> Computer 


2  <—~> 2 TxD 
39 <—~> 3 RXD 
4 <> 4 RTS 
5 <—— > 5 CTS 
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7 <> 7 SG 


CASE 1-B: Wiring if computer has a 25 pin connector and the cable has 9 (or 
more) wires. Same as in CASE 1-A, and also: 


KPC-3 Plus _<——>_ Computer 


1 <—~> 1 FG 
6 <——> 6 DSR 
<— > 8 DCD 
20 <——~> 20 DTR 
CASE 2-A: Wiring if computer has a 9 pin connector and the cable has 5 wires: 


KPC-3 Plus _<——>_ Computer 


2 <—> 3 TXD 
30 <—> 2 RXD 
4 <> 7 RIS 
5 <> 8 CTS 


7 <> 5 SG 


CASE 2-B: Wiring if computer has a 9 pin connector and the cable has 8 or more 
wires. Same as in CASE 2-A, and also: 


KPC-3 Plus_ <——> Computer 


6 <——> 6 DSR 
8 <— > 1 DCD 
20 <——> 4 DTR 


Technical note for advanced users: Two of the first five wires in each chart above 
(RTS and CTS) are used for hardware flow control, so if your program uses just 
software flow control and not hardware flow control, you may not need to use these 
two hardware flow control wires. 
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+ Ifyou are not using a PC compatible computer, the wiring required between your 
computer and your KPC-3 Plus is the same wiring you would use for an external 
telephone modem. This cable should be available from your computer dealer. 
Appendix A of this manual includes details on the functions of the KPC-3 Plus 
pins. The software (terminal program) requirements are also the same as that 
used for a telephone modem. 


Installing the RS-232 Cable 


Once you have purchased or made your serial communication cable, connect it as 


follows: 

Step 1. Make sure that power to both your computer and your 
KPC-3 Plus is turned OFF. 

Step 2. Plug the male DB-25 connector end of the serial cable 
into the “Computer” port of the KPC-3 Plus, 

Step 3. Plug the female DB-9 or DB-25 connector end of the 


serial cable into a serial port of your computer, 


Note: To use Pacterm, the communication software that ships with the KPC-3 Plus, 
you will need to connect to your computer’s COM1 or COM2 port, but with appro- 
priate communication software, the KPC-3 Plus can connect to any COM port ona 
PC compatible computer. Kantronics has programs available for PC compatible 
computers. Programs for other computers may be obtained through your computer 
store. 


Caution: Be sure you do not connect to a parallel port instead of a serial port: the 
KPC-3 Plus communicates serially, so it cannot communicate through a parallel 
port. Computer’s parallel ports (i.e., printer, or LPT port) usually have female 
DB-25 connectors. Do not connect the KPC-3 Plus to a female DB-25 connector 
on the computer unless you are sure it is a serial (COM) port, not a parallel 
(LPT) port. 
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Step 4. Check the connectors at each end of the cable, and se- 
cure the connectors using the mounting screws, 


Step 5. Turn ON the power to your computer, in preparation for 
installing communication software in the computer, but 
leave the KPC-3 Plus power OFF. 


Caution for users of a 25-pin serial modem cable: As originally shipped, the 
KPC-3 Plus does not connect a power source to its serial port, but an advanced 
user can change jumpers so that it does. If your KPC-3 Plus has been altered to ap- 
ply 12 Vdc to pin 13 of the computer (serial) port, this can DAMAGE your com- 
puter if pin 13 is wired. To check to see if your KPC-3 Plus has been changed in 
this way, see the section on jumpers in this manual. Note that the factory default 
setting of the jumper does not connect pin 13. 


This concludes the physical installation of the serial cable needed for your 
KPC-3 Plus and your computer to communicate with each other. 


To verify that your serial cable is correctly wired and connected, you need to 
install communication software in the computer and then use that software to 
establish communication with the KPC-3 Plus. 


Install Software and Configure Your KPC-3 Plus 


After connecting your KPC-3 Plus and your computer with an RS-232C serial 
modem cable, you are ready to: 


e install terminal communication software in your computer to enable 
communication between your KPC-3 Plus and your computer, 


e use the terminal communication software to establish communication 
with your KPC-3 Plus, including setting the speed of communications 
back and forth, and 


e configure your KPC-3 Plus to prepare it for your use, including giving 
the KPC-3 Plus your CALLSIGN and setting KPC-3 Plus parameter 
values. 
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Your KPC-3 Plus ships with a basic terminal communication program called 
Pacterm that will get your packet radio station up and running. 


+ Ifyou are already familiar with a terminal communication program, you may 
wish to use it instead of Pacterm, or you may switch to it after using Pacterm to 
get started. 


A complete manual for Pacterm is included as the next chapter of this documen- 
tation. The Pacterm manual begins on page 61. For an overview of what you can 
do with Pacterm, see page 62. The “Pacterm” chapter includes all the steps 
needed for installing the software and using it to configure your KPC-3 Plus. It 
also will serve as your Pacterm manual as you continue using the software with 
your KPC-3 Plus. 


You may find that the steps described in the Quick Start section of that chapter 
(see page 63) are all you need or you may want to go through the “Pacterm” 
chapter in more detail. For details on setting up BAUD rates, see page 68. 

For information on setting other KPC-3 Plus parameters, see page 69. One step 
that is mentioned only briefly in the ‘““Pacterm” chapter (see page 68) is that after 
you set the BAUD rate for the KPC-3 Plus, you will be asked to enter your 
CALLSIGN, which your KPC-3 Plus will then use until otherwise notified. So be 
prepared to enter your CALLSIGN when asked to do so. 


IMPORTANT: Now go to the “Pacterm” chapter, to install and configure soft- 
ware and KPC-3 Plus parameters and then COME BACK HERE — you still 
need to connect your KPC-3 Plus to your transceiver. 


Connect Your KPC-3 Plus to Your Transceiver 


The last connections you need to establish are between your KPC-3 Plus and 
your transceiver. You will construct and install a transceiver cable assembly that 
has two functions: (1) to send signals from the speaker jack of your transceiver to 
your KPC-3 Plus’s “Radio” port, for processing, and (2) to send signals from 
your KPC-3 Plus’s “Radio” port to the microphone connection of your trans- 
ceiver, for transmission. 


As illustrated in the diagram on page 36, the transceiver cable connects to the 
“Radio” port on the KPC-3 Plus, via a male DB-9 connector shipped with your 
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KPC-3 Plus. Two separate cables, also supplied with the KPC-3 Plus, are at- 
tached to this DB-9 connector (actually, the wires in the cables are attached to 
specified pins on the cable assembly’s DB-9 connector). One cable contains 
wires connecting the KPC-3 Plus (““Radio” port) to the MIC connector on your 
transceiver and the other cable contains wires connecting the KPC-3 Plus (“Ra- 
dio” port) to the speaker jack on your transceiver. 


This section goes step-by-step, dealing with the following questions: 
e what parts will be needed for the assembly? 


e what are the exact wiring requirements for connecting your transceiver to 
the KPC-3 Plus, as determined by information given in this document 
and also by requirements for your own particular make and model of 
transceiver (as determined by the documentation for your transceiver)? 


e what are the steps used in constructing and connecting the cable 
assembly? 


e once the cable is in place, how does one set the volume level of the 
transceiver for optimal performance? 


Parts for Connecting Your KPC-3 Plus to Your Transceiver 


The following parts (shipped with your KPC-3 Plus unless otherwise noted) are 
needed for constructing the cable assembly that will connect your KPC-3 Plus 
and your transceiver: 


e DB-9 connector kit (including hardware), to make the DB-9 connec- 
tor for the end of the transceiver cabling that connects to the KPC-3 
Plus’s “Radio” port, 


e a 3-foot length of 5-conductor shielded cable, to connect the 
user-supplied microphone connector (i.e., the Mic plug) for your 
transceiver to the DB-9 connector supplied with your KPC-3 Plus, 
and 


e A molded 3.5 mm mini-plug and cable, which plugs into your trans- 
ceiver’s speaker jack and connects to the DB-9 connector supplied 
with your KPC-3 Plus. 
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Preparing the Transceiver Cable Assembly 


This section gives instructions for how to assemble the cable assembly needed to 
connect your transceiver to your KPC-3 Plus, starting with the wiring require- 
ments. 


Wiring Directions (Connecting KPC-3 Plus and 
Transceiver) 


You will need to determine which pins on your DB-9 connector will be wired to 
which connections on your particular transceiver’s microphone connector and 
speaker jack. Wiring directions are covered after the following examples of typi- 
cal transceivers,including handhelds. 


+ There are many different models of transceivers, each with their own exact re- 
quirements for how they are to be connected to devices such as a KPC-3 Plus. 
While the following examples will help, you will need to refer to your transceiver 
documentation (or transceiver dealer) for exact instructions on which connections 
you need to make as you wire your transceiver cable assembly. 


Note: If you need further assistance on your radio cabling, contact the radio man- 
ufacturer, your dealer, or a local amateur who has already installed a TNC. 
Kantronics is not likely to have pin assignments for specific transceiver models. 


The following diagrams, used for example only, show wiring connections be- 
tween the male connector for the KPC-3 Plus’s “Radio” port and transceivers (in- 
cluding HTs) from three major manufacturers: Yaesu, Icom, and Kenwood. 


+ These diagrams may also apply to transceivers from other manufacturers, but you 
need to check to be sure how your transceiver needs to be wired. (See the section 
on “Interfacing Hand-Held Radios” in the the “Advanced Installation” appendix 
for further information. 
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[Yaesu diagrams — page G8] 
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[Icom diagrams — page G9] 
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[Kenwood diagrams — page G10] 
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Your Transceiver’s Microphone Connections to Your KPC-3 Plus. 


For the microphone on your transceiver, you may wish to makes notes of the fol- 
lowing connections, which you will use for wiring your assembly: 


e identify and make a note of the microphone input (which will be wired to 
pin 1, transmit audio on the KPC-3 Plus’s DB-9 “Radio” port), 


e identify and make a note of the PTT or STBY connection (which will be 
wired to pin 3, Push-to-Talk on the KPC-3 Plus’s DB-9 “Radio” port), 


e for base or mobile (but not hand-held) transceivers, identify and make a 
note of the ground connection (which, optionally, may be wired to pin 9, 
one of the ground pins on the KPC-3 Plus’s DB-9 “Radio” port, or left 
unconnected). 


Your Transceiver’s Speaker Jack Connections to Your KPC-3 Plus 


For the speaker jack on your transceiver, make a note of the following connec- 
tions, which you will use for wiring your assembly: 


e identify and make a note of the connector to the tip of your external 
speaker plug (which will be wired to pin 5, receive audio on the KPC-3 
Plus’s DB-9 “Radio” port), 


e identify and make a note of the connector to the sleeve of your external 
speaker plug (which will be wired to pin 6, one of the ground pins on the 
KPC-3 Plus’s DB-9 “Radio” port). 


Constructing the Cable Assembly 


As you construct your cable assembly, it may be helpful to refer to the diagram 
on page 36. 


Important: As shown in the diagram immediately below, the pins in the 
KPC-3 Plus’s female DB-9 “Radio” connector are numbered from the upper 
right (pin 1) to the lower left (pin 9). As you connect wires to pins on the DB-9 
connector on your cable, you need to be sure to connect to the correct pins. 

As shown in the diagram below , if you look at the solder side (wiring side) of 
the male DB-9 connector, the pins are numbered (again) from upper right (pin 
1), to lower left (pin 9). 
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+ Similarly, when working with a typical 8-pin Mic connector where you know the 
pin numbers of pins, you need to consider which way you are looking at the con- 
nector (looking at pins/holes or looking at the wiring side, where the wires are 
actually connected). 


[DIAGRAM(s) - top of page G8 of V 5.0 manual] 


+ Hint: Make notes of which wires (colors, cables) you use for each connection, so 
you will be able to keep track of which connection is which. 


To construct your transceiver cable assembly, proceed as follows: 
Wiring between your Transceiver Microphone and your KPC-3 Plus: 


Follow the notes taken above and wire the cable assembly in the following order: 


Step 1. Select the 5-wire microphone cable and the 
DB-9 connector part from the cable assembly kit, 


Step 2. Attach microphone cable wires to the following pins on 
the DB-9 connector: 


* pin | (transmit audio) — and make a note of 
the color of the wire you used, 


* pin 3 (Push-To-Talk) — and make a note of 
the color of the wire you used, and 


* (for base and mobile units) pin 9 (ground for 
microphone on radio) of the DB-9 connec- 
tor— and make a note of the color of the 
wire you used. 

+ Hint: You may find it easier to wire the male DB-9 connector if you first connect 
it to the KPC-3 Plus and use the KPC-3 Plus as a “jig.” This may also keep the 
male pins straight if you apply too much heat and soften the plastic in the male 
connector. 
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Step 3. Using a user-supplied microphone connector appropriate 
for your transceiver and the notes taken above, attach 
wires as follows: 


* attach the wire from pin | (transmit audio) on 
the DB-9 to the microphone connector’s input 
pin, 

* attach the wire from pin 3 (push-to-talk) on the 
DB-9 to the microphone connector’s PTT or 
STBY pin, 

* (optional) for base or mobile units, attach the 
wire from pin 9 (one path to ground) on the 
DB-9 to the ground pin on the microphone con- 
nector. 


Connecting your Transceiver’s Speaker Plug to Your KPC-3 Plus 


Use the speaker plug cable supplied with the KPC-3 Plus (or an appropriate third 
party speaker plug) and the notes taken earlier to do the following wiring to the 
DB-9 connector: 


Step 1. Locate the wire that connects to the tip of the external 
speaker jack and wire it to pin 5 on the DB-9 (Receive 
Audio) 


Step 2. Locate the wire that connects to the sleeve of the exter- 
nal speaker jack and wire it to pin 6 on the DB-9 
(Ground) 


This is all you need to do to wire the speaker plug part of the assembly. 


+ Important: Keep your wiring notes for future reference. 
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Complete the Construction of Your Assembly 
Using the DB-9 kit that ships with the KPC-3 Plus, complete the DB-9 assembly: 


Step 1. Install the strain relief around the two cables whose 
wires are attached to the DB-9 connector, to protect the 
wires from being accidentally pulled from the pins: 


* — select the four parts used for the strain relief: 
(1) two brackets having curves to 
accommodate the cable and (2) two short 
screws, used to connect the brackets to each 
other, 


* arrange the two brackets so the two curves 
form a circle (to surround the cable), with 
the two threaded (thicker) holes on the 
brackets (one on each bracket) on opposite 
sides of the assembly, 


* use one of the screws to connect the two 
brackets, passing the screw through the hole 
on the thin side of one bracket and attaching 
it (screwing it into the threads) to the other 
bracket, 


* place the two cables into the circle formed 
by the two brackets, examine the back shell 
assembly to see how far up the cable from 
the DB-9 pins the strain relief brackets will 
need to be to fit into the back shell (in the 
slot just before the cable exits the back shell 
assembly), and position the brackets around 
the cable at that point on the cable, 


* fasten the two brackets with the second short 
screw (which will go in the opposite direc- 
tion from the first) and tighten the screws, to 
secure the cable in the strain relief assembly. 
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Step 2. 


Connect Your KPC-3 Plus to Your 


Install the back shell assembly around the DB-9 connec- 
tor and cable(s): 


select the parts needed: (1) the two shells that 
will be arranged to contain the DB-9 connector 
and the cables (and the strain relief attached to 
the cables), (2) two long half-threaded screws 
and two shaped washers, to attach the whole as- 
sembly to the KPC-3 Plus, and (3) two long, 
fully-threaded screws to connect the shells to 
each other (not the long screws that are only half 
threaded — those will be used later, to attach 
the DB-9 connector to the KPC-3 Plus) and the 
two nuts to attach to these two screws. 


beginning with one of the back shell parts 
(which will be the bottom shell during assem- 
bly), fit the DB-9 connector into the slot at the 
wide end of the shell (with pins facing away 
from the shell and cables resting inside the 
shell), with the backplane of the DB-9 connector 
fitting behind the lip that protrudes slightly from 
the bottom of the shell, 


tuck the cable(s) into the semi-circular gap at the 
small end of the shell and, after any necessary 
adjustments, fit the strain relief assembly into 
the space between the end of the shell where the 
cable exits the shell and the pair of threaded col- 
umns (with holes for screws), 


place one of the shaped washers on each of the 
long, half-threaded screws, so they are next to 
the head of the screw (with the bent ends of the 
washers facing away from the heads of the 
screws), 


fit the top shell onto the bottom shell (which 
now contains the connector and cable), so the 
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two parts are touching from front to back, 
and hold the parts loosely together, 


* while holding the DB-9 connector in place 
in the shell, insert the two long, 
half-threaded screws (with their washers) 
into the holes on either side of the 
back-plane of the DB-9 connector, until the 
washers (and screw heads) contact the 
shoulder on the shell and fit in the 
semi-circular gap in the shell designed to 
hold the screw in place, 


* fasten the two sides of the shell together us- 
ing the screws and nuts selected above. 


This completes the construction of your transceiver cable assembly. Now it needs 


to be connected. 


Connecting Your Transceiver Cable Assembly 


Now you are ready to use this cable assembly to finish assembling your packet 


radio station. 


Step 1. 


Step 2. 


Step 3. 


Step 4. 


Check to be sure all the parts of your completed cable 
assembly are properly fastened and ready for connection 
to your transceiver and your KPC-3 Plus. 


Turn OFF all power. 


Plug the male DB-9 connector on the cable into the 
female DB-9 connector on the KPC-3 Plus’s “Radio” 
port, 


Secure the male DB-9 connector on the cable to the 
female DB-9 connector on the KPC-3 Plus’s “Radio” 
port, by screwing the two long, half-threaded screws into 
the threaded nuts on each side of the KPC-3 Plus’s “Ra- 
dio” port, 
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Step 5. Plug both the microphone connector and the external 
speaker jack into your transceiver. 


Adjusting the Receive Volume of Your Transceiver 


To adjust the receive volume of your transceiver to the proper level (or to con- 
firm that it is already set at the proper level), do the following: 


Step 1. Turn ON your computer (with your transceiver OFF), 
Step 2. Start your terminal program,, 

Step 3. Turn ON your KPC-3 Plus, 

Step 4. If not already done (using Pacterm), set the KPC-3 


Plus’s baud rate (ABAUD) and CALLSIGN, 


Step 5. Turn ON your transceiver and open the squelch control 
(turn it fully counter-clockwise), 


Step 6. Slowly turn the transceiver’s receive volume up until the 
RCV LED (receive indicator) on the KPC-3 Plus lights 
up (turns ON), 


Step 7. Increase the transceiver’s receive volume control slightly 
above the point at which the KPC-3 Plus’s RCV LED lit 
up (turned ON), 


Step 8. Slowly turn the transceiver’s squelch control clockwise 
until the KPC-3 Plus’s RCV LED goes OUT (turns 
OFF), 


Now the receive volume control on your transceiver is properly adjusted for 
sending signals to your KPC-3 Plus. 


Your KPC-3 Plus is now installed and ready to use. You may now go to the 
“Getting Started” chapter, to learn how to do the basic operations with your 
KPC-3 Plus. 
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+ 


If you do not see the receive LED light, check the cabling between the radio and 
the KPC-3 Plus. Also, until it has been initialized from the computer, the KPC-3 
Plus will not show ANY indication of receiving. 

If you connected to a fixed level (unsquelched) receive audio from the radio, the 
receive LED may remain on all of the time. In this case, set the parameter CD to 
SOFTWARE. Then, the receive LED will not light until valid packets are heard. 
(see CD in the commands section) 


Transmit level adjustment 


The 1200 baud data drive level (transmit audio voltage, TXA) from the KPC-3 
Plus to your radio is adjusted digitally, using your keyboard and the transmit 
level (XMITLVL) or the calibrate (CAL) command. Previous models used a set 
of jumpers and an analog potentiometer (pot) to set this level. With the KPC-3 
Plus, no jumpers are used, just a command. 


You should adjust the drive level to provide about 3 to 3.5 kHz of deviation with 
your radio. If you don’t have access to a deviation meter, adjust drive so your 
packet transmissions generate about the same audio sound as packets heard from 
other stations. 


The XMITLVL command has a parameter default value of 100; this corresponds 
to a drive voltage of about 50 mV. You may change this level by increasing the 
parameter/count. For counts below 256, the voltage is increased in 1/2 mV steps; 
above that, the drive increases roughly 15 mV per step. 


For details, see the description of the XMITLVL command in the “Command 
Reference.” 


Alternatively, you may use the calibrate command (CAL) which has a zoom fea- 
ture; that is, you can hold down the ‘-’ or ‘+’ key to decrease or increase the volt- 
age (as you watch a meter or listen). See the commands section for more detail 
on these commands. CAL is not available in the NEWUSER mode; you must be 
in TERMINAL mode to access CAL. 


The next section of this chapter is for those who wish to connect a GPS device to 
their KPC-3 Plus. Skip this section if it does not apply to you. 
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Connecting to a GPS Device (Optional) 


To use your KPC-3 Plus with a Global Positioning System (GPS) device, you 
need to connect the GPS device to the DB-25 “Computer” port (i.e., serial port) 
on the back of the KPC-3 Plus, in place of the computer. 


Since you need to remove the computer’s serial modem cable from the KPC-3 
Plus’s “Computer” port and replace it with the GPS’s cable before you can use 
the GPS device with the KPC-3 Plus, you will need to use your computer to con- 
figure your KPC-3 Plus to work with the GPS device before you connect your 
GPS device to your KPC-3 Plus. 


Note: You can attach both the KPC-3 Plus and a GPS device to your computer at the 
same time, using an APRS HSP (hardware single port) cable and the APRS pro- 
gram. 


Since cabling may vary from one GPS vendor to another, the cable is not sup- 
plied with your KPC-3 Plus. You will need to purchase or make a cable, using the 
specifications in your GPS manual. 


To connect the GPS receiver and the KPC-3 Plus as a “Stand-alone” position re- 
porting system without a computer, you will need to connect a minimum of 2 
wires for data flow from the GPS receiver to the KPC-3 Plus. Connect the GPS 
receiver “DATA OUTPUT” to TXD (pin 2) on the KPC-3 Plus. Connect the GPS 
receiver “SIGNAL GROUND” to signal ground (pin 7) on the KPC-3 Plus. Your 
GPS receiver may require other pins to be connected, check its documentation. 


See your GPS manual and the chapter in this manual on “GPS NMEA 
Interfacing Capability” for details on using your GPS device with your KPC-3 
Plus based packet radio station. 


This concludes the installation of your station. 
+ For more information on installation topics, see the appendices. 


Since you used the next chapter (“Pacterm’”) as part of the installation process, 
you can now skip over to the chapter on “Modes of Operation” and get started 
using your KPC-3 Plus. 
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Introduction 


Pacterm is a DOS-based terminal communication program used to control the 
flow of information between your PC compatible computer and your TNC. 
Pacterm is shipped with the TNC to help you get started using your TNC for 
packet radio communication. Pacterm is for use while the TNC is operating in 
NEWUSER Interface Mode (the default mode of operation) or in TERMINAL 
Interface Mode, which includes all NEWUSER commands and many more. 


+ We suggest that you start with the chapter “Installing Your TNC,” switch 
here, when instructed, to set up Pacterm, and then to go back to the “In- 
stalling Your TNC” chapter to complete installing your packet radio station. 


After setting up your TNC, you may use another terminal communication program. 
Kantronics offers an upgrade path to a full-featured, multi-tasking terminal communica- 
tion program for users of Windows 95 or Windows NT - Pacterm ‘98. Pacterm ‘98 uses 
Kantronics’ HOST mode to supports all modes of operation in all Kantronics TNCs (at 
firmware v 5.0 or above). 


Technical Note: With appropriate cabling, software and adapters, the TNC also 
will operate with non-PC compatible computers and “dumb terminals.” 


Our Assumptions About You 


We assume the following when you use Pacterm with your TNC: 


e You are using a PC compatible computer that meets the specifications 
given in your TNC documentation. 


e You know, or are learning, how to use DOS with your PC compatible 
computer for basic operations needed to install and run Pacterm. 


e You have a TNC that is connected, or that will be connected, to your PC 
computer, as described below and in the TNC manual. 


e You know, or are learning, how to use your TNC in NEWUSER and/or 
TERMINAL Interface Mode, along with your PC compatible computer 
and your transceiver, for packet radio operations. 
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Overview 


You can use Pacterm to do the following: 


e Establish communications between your computer and your TNC, while 
it is operating in NEWUSER or TERMINAL Interface Mode. 


e Select the COM PORT and BAUD RATE to use for the current 
Pacterm session (i.e., until you exit to DOS). 


e Send commands from Pacterm to your TNC. 


e Send data from Pacterm (i.e., from your computer) to your TNC and 
receive data from your TNC. 


e VIEW, PRINT, and/or SAVE information sent from your TNC to your 
computer. 


e End a session, either of two ways: 
e Disconnect and EXIT to DOS. 
e EXIT directly to DOS. 


Other uses of Pacterm are as follows: 
e SEND a file from your computer to your TNC, for transmission. 


e Switch the TNC at any time into Command Mode, making it ready to 
accept commands instead of transmitting data. 


e Control the flow of data between Pacterm and your TNC, as follows: 


e From Pacterm to your TNC: Switch between (1) ONLINE, with your 
input sent immediately or (2) OFFLINE, with input stored in a 
type-ahead buffer and sent when you go back ONLINE. 

e From your TNC to Pacterm: STOP (hold) or START the flow of data 
from your TNC to your computer. 


Technical note: Also, as described briefly in this document, Pacterm can be used 
with KAM TNCs to operate in HF non-packet modes. 
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Quick Start 


To get started right away using Pacterm to communicate with your TNC: 


1. Copy the file PACTERM.COM from your “Kantronics Program and Infor- 
mation Disk” to your hard drive, using DOS or following directions on the 
disk. 


2. Connect your TNC to COM1 or COM2 of your computer, using a standard 
RS-232C serial modem cable, and make sure the TNC is turned ON. 


3. Use DOS to change to the drive and directory to which you copied Pacterm. 
4. Start Pacterm by typing PACTERM and pressing the ENTER key. 


5. When Pacterm starts, you will be on the MAIN Menu. Use the SETUP func- 
tions on the MAIN menu as needed to establish communication with your 
TNC. The BACKSPACE key will take you to the TERMINAL Screen. Fol- 
low the on-screen instructions and use the MAIN Menu and the TERMINAL 
Screen to control the session and communicate with the TNC. 


6. Ifyou get the “Pacterm Cannot Communicate” screen the first time you try to 
go to the TERMINAL Screen, be sure the TNC is turned ON and/or press the 
F7 key to switch the current COM port from COM2 to COMI. If neither of 
these works, review other possible problems (described on the screen) and 
keep trying until you establish communication. 


7. The first time your TNC is used, it will run an AUTOBAUD routine to coor- 
dinate the TNC’s BAUD rate with the BAUD rate of the terminal communi- 
cation software in use at the time — in this case, Pacterm. Follow the 
on-screen instructions, which include entering your CALLSIGN, and then 
proceed. 


You may be able to get up and running without reading any more of this Pacterm 
documentation, but you will find much useful information below, including: 
(1) detailed explanations of each function, (2) helpful hints, (3) cautions that 
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warn of possible problems, and (4) technical notes for those who are interested in 
knowing more about a particular topic. 


Installing Pacterm 


Installing Pacterm is a simple matter. You will copy the program file 
PACTERM.COM to your computer’s hard drive or to a floppy disk. You will find 
the file PACTERM.COM on the floppy disk titled “Kantronics Program and 
Information: Disk 1," that is shipped with the TNC. 


Caution: To reduce the chance of problems later, make a backup copy of this 
shipping disk and write-protect both the original and your backup copy. 


Saving Pacterm on Your Hard Drive 


You may copy Pacterm to your hard drive just by using DOS commands or by 
following the steps given on the “Kantronics Program and Information” disk. 


Copying files from a floppy to your hard drive 


You may install Pacterm on your hard drive by simply copying the Pacterm 
program file to the drive and directory or subdirectory of your choice, as follows: 


1. Change to the main directory (e.g., C:\) or an existing subdirectory of your 
hard drive (e.g. C:\COMM), 


+ Hint: To create a new directory in which to save Pacterm, use the DOS make 
directory command. For example, if your hard drive is drive C and you want to 
create a new directory called PACTERM in which to store the program (also 
called Pacterm), first change to drive C (type and enter C:) and then type and 
enter MD \PACTERM — being sure to include the backslash. Then change to 
the new directory by using the change directory command: type and enter 
CD \PACTERM — again, be sure to include the backslash. 


2. Put the “Kantronics Program and Information” disk in floppy Drive A (or B), 
and 
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3. Type COPY A (or B):PACTERM.COM and press the ENTER key. This 
will copy PACTERM.COM to your current directory (shown at your DOS 
prompt). 


Guided Installation 


Another way to install Pacterm on your hard drive is to use the Kantronics Pro- 
gram and Information disk to guide you through the steps, as follows: 


1. Put the Kantronics Program and Information disk (or a backup) in a floppy 
drive (e.g., A or B) and, if you are not already there, change to the floppy 
drive where you put this disk (e.g., type and enter A: or B: as appropriate), 


2. Type TNC and press the ENTER key, to start the TNC program, and use the 
on-screen menus to select PACTERM, then INSTALL PACTERM, and 
then follow the on-screen instructions, 


3. Type and enter the drive to which you want Pacterm copied (e.g., C), which 
can be any drive (except the floppy drive with the Kantronics Program and 
Information disk it it) that has the space for it, 


4. Next, type and enter the directory or subdirectory (e.g., \PACTERM) to 
which you want Pacterm (the program) copied. If you specify a directory or 
subdirectory that does not already exist, the installation program will create it 
and then copy PACTERM.COM there. 


5. Check the on-screen confirmation of the installation and EXIT to DOS. 


Saving Pacterm on a Floppy Disk 


You may use the Pacterm program on the backup copy of the “Kantronics 
Program and Information: Disk 1" disk or on another floppy disk (a disk to which 
you have copied the file named “PACTERM.COM”). In this case, you do not 
need to do anything special to install it. Just follow the “Starting Pacterm” 
instructions given below. 
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Establishing Communication 


For Pacterm to communicate with your TNC, these conditions must be met: 


The TNC is turned ON. 


The TNC is connected to your computer’s COM1 or COM2 port and 
Pacterm is set to expect it on the COM port to which it is connected. 


The PC computer and the TNC are connected via a standard RS-232C 
serial modem cable, or at least by the 5-wire cabling described in the 
TNC documentation. 


The COM port is functioning properly (e.g., cable is plugged in 
securely). 


There are no other faults in the normal operations of the components or 
connections between them. 


When you first try to communicate with the TNC, Pacterm checks for a signal 
from the current COM port that is consistent with a TNC. If it does not find such 
a signal, Pacterm presents the “Pacterm cannot communicate” screen shown be- 
low, for your use in establishing the connection. 


KANTRONICS PACTERM (Ver. 2.0) Terminal Communications 

<3 Pactecw cnimok ‘combuiicste witli dauicecot the caueneine SERIAL (COM) port 

Current COM port = COM2 (Press F? to try the other COM port: COM1 or COM2) 

EXPLANATION: Pacterm needs to receive a “Clear To Send” (CTS) signal from 
the current COM port to communicate with your TNC. 


NOTE: When Pacterm DOES get this signal, it cannot tell whether it is 
from your INC or from another device (e.g., internal modem, mouse). 


GETTING CONNECTED : 
1. Is your TNC turned ON? If not, turn it ON now. 


2. Is your TNC connected to the current COM port Ci.e., COM2)?. 
If NOT, Press the F? key to change the current COM port. 


3. Is your serial cable wired incorrectly? Press ESC to EXIT and check it. 
4. To check for other problems with your COM port, press ESC to EXIT to DOS. 


5S. If Pacterm still cannot connect, press ESC and seek further assistance. 


F? = Select COM port: COM1 or COM2 (default) ESC = EXIT to DOS 


If you have further difficulty establishing or maintaining communications, see 
the trouble-shooting section at the end of this chapter for possible solutions. 
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Starting Pacterm 


To start Pacterm, once you have connected your TNC to your computer: 


1. 


Use DOS to go to the drive and directory where you have installed Pacterm. 
For example, if you copied Pacterm to “C:\COMM” by using the Install pro- 
gram, type “C:\COMM”, then press the ENTER key and you will see the 
prompt “C:\COMM”. 


Hint: If you are using Microsoft Windows 3.1 or above, you can use the Pro- 
gram Manager, File Manager, or click on the DOS icon in the Main Window to 
run Pacterm as a DOS program from within Windows. But do not run any other 
program at the same time as Pacterm, or you may lose data. 


Type PACTERM and press the ENTER key. 


Hint: The drive and directory from which you call Pacterm does not need to be 
the same as that where the program is stored. From Pacterm’s point of view, the 
current drive and directory (e.g., used for SAVING the Holding Buffer) is the 
drive and directory from which you start Pacterm. For example, suppose the 
program PACTERM.COM is in C:\COMM (:.e., drive C, directory COMM) 
and you are on directory SAVEBUFF on a disk in drive A 

(A:\SAVEBUFF). In this case, the DOS command C:\COMM\PACTERM will 
start Pacterm and the current drive and directory will be A:\SAVEBUFF. 


The first screen you will see is the MAIN Menu screen. Use the SETUP 
functions as needed, then you are ready to go on to the Terminal Screen. 


Press the BACKSPACE key on the MAIN Menu to go to the Terminal 
Screen and begin using Pacterm for communicating with your TNC. 


If Pacterm cannot establish communication, it will assist by presenting a 
“Pacterm cannot communicate” screen (shown above), which describes steps 
you can take to establish communication. You may just need to turn on your 
TNC and/or press the F7 key to tell Pacterm to try communicating through 
COM1, instead of the default serial port, COM2. As soon as Pacterm can 
communicate, it gives you the MAIN Menu, so you can try again. 
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Coordinating Pacterm and Your TNC 


Several TNC parameter values affect how Pacterm communicates with the TNC. 


Coordinating BAUD Rates: The Autobaud Routine 


The first time your TNC is used, it runs aa AUTOBAUD routine to assure that 
the TNC baud rate is the same as that of Pacterm (or whatever communication 
software is in use at the time). 


The TNC’s AUTOBAUD routine works as follows: 


1. AUTOBAUD sends and resends the message “PRESS (*) TO SET BAUD 
RATE” to Pacterm, at one baud rate after another. When the TNC’s baud rate 
matches that of Pacterm, you can read this message in a window on your 
screen; if the two rates do not match, the message appears garbled. 


2. Any time while this message is being sent, whether it is readable or garbled 
on your screen, enter the “*” character (SHIFT+8 key combination). 


3. When the AUTOBAUD routine receives, the “*” character from the serial 
port, it uses that character to determine Pacterm’s BAUD rate. 


4. AUTOBAUD then sets the TNC’s BAUD rate to match Pacterm’s BAUD 
rate. The TNC’s BAUD rate will be set to 9600 (Pacterm’s default BAUD 


rate) unless Pacterm’s BAUD rate was changed before running 
AUTOBAUD. 


Technical note: The TNCs BAUD rate is stored in the TNC as the value of the 
ABAUD parameter, so when you use the TNC later, it will start with that BAUD 
rate. This is made possible by an internal lithium battery supplied with the 
TNC. Later, you can change the TNC BAUD rate if you want, as long as you 
change Pacterm’s BAUD rate to match the new TNC BAUD rate. 


5. Finally, AUTOBAUD: (1) sends a “sign-on” message and (2) asks for the 
user’s CALLSIGN, which will also be stored in the TNC and used until 
changed. At this point, the user is ready to give commands to the TNC. 
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+ Hint: Do not confuse the TNC’s baud rate for serial communication on the 
computer port with the TNC’s 1200 baud rate for communicating using the ra- 
dio port, which is connected by a custom-wired cabling to a transceiver. 


Configuring the TNC for Use with Pacterm 


There are several TNC settings in addition to ABAUD (baud rate) and MYCALL 
(CALLSIGN) that you may wish to change, especially if parameter values in 
your TNC have been changed from their default settings. Even if you do not want 
to change anything now, knowing about these parameters and knowing how to 
reconfigure your TNC, gives you more control in using it with Pacterm. 


Required TNC Parameter Settings 
To work with Pacterm, the following TNC parameter settings are needed: 
¢ COMMAND = $03 (CTRL+C) (default = $03, so unless this has been 
changed, you do not need to do anything). 


+ Hint: Pacterm has a fixed code that it sends for COMMAND and it is 
the same as the TNC default value (HEX $03, which is CTRL+C from 
the user’s point of view). That is, Pacterm assumes the TNC COM- 
MAND parameter is set to its default value; if it is not, Pacterm com- 
mands that send CTRL+C codes to the TNC will not work correctly. 


e Each of the following TNC parameters needs to be set to its default 
value, shown below, if it has been changed to a non-default value: 


* CANLINE default = CTRL+X (HEX $18) 
e CANPAC default = CTRL+Y (HEX $19) 
« PASS default =CTRL+V (HEX $16) 


KPC-3 Plus v 8.2 69 User’s Guide 


Pacterm v 2.0 Coordinating Pacterm and Your TNC 


Optional Parameter Settings 


The following TNC parameters are generally used with their default settings 
when running Pacterm, but you may wish to change them. If they have been set 
to non-default values, you may wish to change them back. 


e ECHO = ON (default) 
e FLOW = ON (default) 


Technical note: Usually, ECHO and FLOW go together, both ON or both 
OFF: When using software that supports split screen displays, for example, 
set both ECHO and FLOW to OFF 


e XFLOW = ON (default) 


Technical note: XFLOW controls whether or not software flow control is 
ON. IfXFLOW is set to OFF, the following parameters should also be set to 
0 (zero): XON, XOFF, START, and STOP. 


e FILTER = OFF (default) 


e 8BITCONV = ON (default) 


+ Hint: Also, the MONITOR parameter may be ON or OFF (default = ON). 
You may have Monitor ON while using Pacterm. But to prevent a build-up of 
data in an internal buffer in the TNC, you should turn Monitor OFF when exiting 
Pacterm and leave the TNC ON. This is because when the TNC’s receive buffer 
is full, your station will give a BUSY signal to other stations that try to connect. 


User’s Guide 70 KPC-3 Plus v 8.2 


Pacterm Screens Pacterm v 2.0 


Pacterm Screens 


Pacterm has two screens for your use in working with your TNC: 
e AMAIN Menu Screen, for setting up the communication, and 


e ATERMINAL Screen, for sending commands and data to your TNC, 
viewing data sent to Pacterm by your TNC, and using the functions 
described on the MAIN Menu (except SETUP functions and ESC). 


The MAIN Menu Screen 


As shown below, the MAIN Menu screen shows all the functions available in 
Pacterm and serves as a “Help” screen as well. 


KANTRONICS PACTERM (Ver. 2.0) Terminal Communications MAIN MENU 


Current SETUP: TNC USE = Packet, SERIAL PORT = COM2, BAUD RATE = 9600 


NOTE: Going to TERMINAL Mode when the current SERIAL (COM) PORT is 
not connected to a TNC may require restarting your computer. 


Press BACKSPACE to go to TERMINAL Screen ESC = EXIT to DOS 


SETUP (and remain on the MAIN MENU) 
F3 = Select TNC USE: Packet (default) or HF Non-Packet 
F? = Select SERIAL PORT: COM1 or COM2 (default) 

F8 = Select BAUD RATE: 300, 600, 1200, 2400, 4800, or 9600 (default) 
CONTROL THE FLOW OF DATA BETWEEN PACTERM AND TNC ————HHH———_- 
FS = PACTERM —> TNC: OFFLINE/ONLINE Ci.e., type ahead/immediate transmit) 

F6 = TNC —> PACTERM: STOP/START CRE: OK for TNC to send data to Pacterm) 
OUTPUT CONTROL. AAS AAA 

ALT+P = Printer: ON/OFF 

ALT+B = Holding Buffer: OPEN/CLOSE 


ALT+#C = Holding Buffer: CLEAR 
F2 = Holding Buffer: SAVE & CLEAR 
ALT+F = File: SEND to TNC 

EXIT 


F9 = Go to TNC “Command” mode 
F10 = Disconnect and EXIT to DOS 


Each MAIN Menu function is described in detail later in this manual. 


To go to the TERMINAL Screen from the MAIN Menu, press the BACKSPACE 
key or use any MAIN Menu function other than SETUP functions, F10, or ESC. 
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The Terminal Screen 


As shown below (in an example showing Pacterm connected to a KPC-3), the 
Terminal Screen is in three parts, a viewing area, an input area, and a status line: 


Viewing area 
(see data sent 
to Pacterm from 


I 
the TNC) | I 
le I 
| 

KANTRONICS PACKET COMMUNICATOR III VERSION 6.0 | 
| (C) COPYRIGHT 1988-1995 BY KANTRONICS INC. ALL RIGHTS RESERVED. I 

| DUPLICATION PROHIBITED WITHOUT PERMISSION OF KANTRONICS. 
Input area  ondzend: I 
(see material I 
entered, to send ! I 
to the ces I 
: I 
Status Line—_y! FisHAIN Menu  F10=Discomect & EXIT ONLIN START RIS CTS) 


as es a a" yh” a > Se ay Fe mn ty Se Me, Se” “em i> fe sy ce Se = 


The Status Line 

The Status Line gives the following information, from left to right on the line: 
e Reminders of how to get to the MAIN Menu and how to EXIT to DOS. 
e The current status of Flow Control Functions: 


e Shows whether the user has set Pacterm to send data immediately to 
the TNC (ONLIN) or to hold data to send it later (OFLIN). 


e Shows whether the user has set Pacterm to request the TNC to send 
data (START) or not to send data (STOP) . 


e The current status of Output Control Functions: 

e Ifthe PRINT request is ON, PRINT is shown on the Status Line. 

e Ifthe Holding Buffer is OPEN, BUFF is shown on the Status Line. 
e The current status of Hardware Control signals: 

e While Pacterm permits the TNC to send it data, RTS is shown. 

e While the TNC permits Pacterm to send it data, CTS is shown. 
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To go from the TERMINAL Screen to the MAIN Menu, press the F1 key. 


Pacterm Commands: Overview 


The following sections provide detailed specifications, helpful hints and technical 
information on Pacterm commands. You may refer to this material now or just 
start using the program and come back here later if you need more information. 


On-Screen Help 


The MAIN Menu screen and Terminal Screen have enough information so you 
can use them as a guide to the commands available. 


From MAIN Menu, BACKSPACE = Go to Terminal Screen 
Pressing BACKSPACE to go to the Terminal Screen is the usual first step in a 
session, once your COM port and BAUD rate are set up as you need. 


MAIN Menu keys (except those used for SETUP or for EXIT to DOS) can also 
be used to go to the Terminal Screen. 


From Terminal Screen, F1 = Go to MAIN Menu 


After you SETUP Pacterm and begin using the Terminal Screen, you will never 
need to return to the MAIN Menu, except to change SETUP values 
(COM port or BAUD rate) for the current session. 


With the following exceptions, all commands that work on the MAIN Menu will 
also work from the Terminal Screen: 


e SETUP commands only work on the MAIN Menu. 


e ESC and CTRL4C are interpreted as data in TERMINAL MODE, 
so use them as data, not as ways to EXIT to DOS. 


+ Hint: To EXIT Pacterm from the Terminal Screen, use F10, or go to the MAIN 
Menu and use ESC or CTRL+C from there. 
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Commands: Setup, Using the MAIN Menu 


Pacterm needs to know a few things in order to communicate with your TNC: 


1. What mode of communication will you be using: packet or HF- Non-Packet. 
If you are using a TNC (e.g. KPC-3 Plus), then you’ll be using packet. 
Pacterm accommodates non-packet modes too for multi-mode Kantronics 
TNCs (e.g. KAM Plus). 


2. What COM port is going to be connected to the TNC? The default “current 
COM PORT” is COM2, but you can switch to COM1. 


3. What BAUD rate should Pacterm use to send data to the TNC? The default is 
9600 BAUD, but you can select any of the following BAUD rates: 300, 600, 
1200, 2400, 4800, and 9600. 


+ Hint: Pacterm begins each session with the default settings for COM port 
(COM2) and BAUD rate (9600), so if you are using non-default setting(s), you 
will need to use the relevant SETUP function(s) to start each session. 


F3 = Select TNC Use (Default = Packet) 


Pressing F3 switches back and forth between two uses of your TNC: with Packet 
communication (default) or with HF Non-Packet communication. The current 
setting for this is shown on the MAIN Menu screen. 


TNC users should always have Packet selected. Kantronics’ KAMs can operate 
using either Packet or HF Non-Packet communication. Several functions work 
differently in HF Non-Packet, so you should not select HF Non-Packet communi- 
cation unless that is what you want to do. 


+ Hint: If you accidentally press the F3 key and switch uses of your TNC, you will 
know right away because: (1) the display of the current TNC use will change 
from Packet to HF Non-Packet, and (2) a box will appear in the lower right of the 
screen, showing additional functions that are for use with HF Non-Packet 
communication instead of Packet communication. To switch back from 
HF Non-Packet to Packet communication, simply press F3 again. 
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F7 


F8 


= Select SERIAL PORT (Default = COM2) 


The TNC can operate with any COM port on your computer, but Pacterm can 
only be used with COM1 or COM2. 


Pressing F7 switches the current COM port from COM2 to COMI, or back. 
Pacterm’s default COM PORT is COM2, so you do not need to do anything if 
you have your TNC connected to COM2. 


If you have your TNC on COM rather than COM2, you will need to press the 
F7 key each time you start Pacterm. Just press F7 on the MAIN Menu before 
pressing BACKSPACE to go to the Terminal Screen. 


Hint: You could also use F7 to switch between two different TNC’s, one con- 
nected to each COM port. 


= Select BAUD RATE (Default = 9600) 


Pacterm can send and receive data through the current COM port at any of the 
following BAUD rates: 300, 600, 1200, 2400, 4800, 9600 (default). 


Technical note: At these levels, baud rate is essentially the same as 


bits-per-second. 


Press F8 to step through the available baud rates. Pacterm’s current BAUD rate is 
shown on the MAIN Menu. 


Since data flows back and forth between Pacterm and your TNC, both need to be 
using the same BAUD rate for the communication to work. Pacterm always starts 
a session at 9600 BAUD. If your TNC is also set for 9600 BAUD, you will not 
have to change the setting. 


Hint: If data sent from the TNC is garbled in the Viewing area of Pacterm’s Ter- 
minal Screen, this may be due to a mismatch between the Pacterm and the TNC 
BAUD rate. One way to coordinate them is to use F8 to step through various 
BAUD rates for Pacterm, until incoming data is readable. Of course, this may 
mean settling for a common BAUD rate that is less than optimal. Another way to 
fix the mismatch is to change the TNC’s ABAUD parameter to match Pacterm’s 
current BAUD rate. See the TNC documentation on the ABAUD command for 
details on how to do this. 
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Commands: Controlling the Flow of Data 


Data are ordinarily sent immediately from Pacterm to the TNC, and from the 
TNC to Pacterm, but you may halt the flow of data in either direction. 


Technical note: To avoid losing data, Pacterm and the TNC each need to know 
when they have “permission” to send data to the other. Pacterm and the TNC 
achieve this coordination using hardware flow control signals on the RS-232C ca- 
ble connecting the two devices: (1) the TNC changes the status of the CTS (clear to 
send) signal on one wire in the cable to tell Pacterm whether it is OK or NOT OK to 
send it data, and (2) Pacterm changes the status of the RTS (request to send) signal 
on another wire in the cable to tell the TNC whether it is OK or NOT OK for the 
TNC to send data to Pacterm. The current status of each hardware control signal is 
shown on the right end of the status line (RTS is shown if RTS is ON; CTS is shown if 
CTS is ON) 


F5 = Pacterm to TNC: Offline or Online (Default) 


Pressing F5 (from either the MAIN Menu or the Terminal Screen) switches be- 
tween two options controlling when data are sent from Pacterm to the TNC: 


1. ONLINE = immediate transmission of data to the TNC as you enter it from 
the computer (default setting), and 


2. OFFLINE = type ahead, which orders Pacterm to stop the immediate trans- 
mission of data and save the data in a transmission buffer, also called a 
type-ahead buffer, for transmission to the TNC when you switch back ON- 
LINE. 


Caution: Don’t go OFFLINE for long. Pacterm’s type-ahead buffer (transmis- 
sion buffer) holds a maximum of 1,024 characters, after which old data will be 
discarded to make room for new data (i.e., it is a “first-in first-out” buffer) 


The status line on the Terminal Screen shows either ONLIN or OFLIN. 
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F6 = TNC to Pacterm: STOP or START (Default) 


Pressing F6 (from either the MAIN Menu or the Terminal Screen) switches 
between the following two options for data-flow from the TNC to Pacterm: 


1. START = Request that data be sent from the TNC to Pacterm, beginning with 
any data previously held in the TNC while data-flow from the TNC was 
STOPPED. 


2. STOP = Do not send data from the TNC to Pacterm; instead, hold it for send- 
ing when data-flow from the TNC is enabled (START). 


+ Hint: While the TNC is STOPPED from sending to Pacterm, data are saved in 
the TNC in a temporary buffer, until the buffer is full. When this buffer is full, 
your station will give a BUSY signal to other stations that try to connect. 


The status of this command (START or STOP) is shown on the Status Line. 


Technical note: START is a request for the TNC to send any new data to Pacterm. 
Before new data will actually be sent to Pacterm, however, Pacterm must be able to 
receive material (RTS is ON), as indicated by RTS shown on the Status Line. While 
it is SAVING the contents of the Holding Buffer, for example, Pacterm turns RTS 
OFF automatically, so new material from the TNC will not be lost during the saving 


operation. 


Commands: Output Control 


Pacterm provides the following output controls: 
e PRINT data as it is shown in the Viewing area of the Terminal Screen. 


e SAVE data shown in the Viewing area of the Terminal Screen in a 
Holding Buffer, whose contents can later be saved as a file. 


e SEND acopy ofa file to the TNC. 
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ALT+P = Printer: ON or OFF (Default) 


This controls whether or not new material appearing in the Viewing section (top) 
of the TERMINAL Screen will also be sent to your printer. Pressing the ALT+P 
key combination from either the MAIN Menu or the Terminal Screen switches 
PRINT from OFF to ON and from ON to OFF. 


+ Hint: If you request printing and your printer is not turned on, is out of paper, or 
is otherwise unavailable, Pacterm will let you know, so you can correct the prob- 
lem and try again. 


The word PRINT appears on the Status Line when the Print request is ON. 


Pacterm assumes that your printer is (1) a generic dot matrix text printer, such as 
an Epson MX, which operates on a line by line basis, responding to carriage re- 
turns and line feeds, and (2) connected to your computer’s LPT1 port. 


+ Hint: If your printer (e.g., some laser printers) cannot be configured to operate as 
Pacterm requires, you may get print-outs by copying material to the Holding 
Buffer, saving it as a file, then using any text editor or word processor to bring in 
the (ASCII) file and print it. 


Caution: Using ALT+P to turn PRINT OFF while printing may cause errors. 


ALT+B = Holding Buffer: OPEN or CLOSE (Default) 


This command OPENS and CLOSES Pacterm’s Holding Buffer, which can be 
used to store and later save up to 45K of data sent from the TNC to Pacterm. 


To OPEN the Holding Buffer, press the ALT+B key combination; to CLOSE it, 
press the ALT+B key combination again. You may OPEN and CLOSE the buffer 
as you wish, until it is full, to “grab” the parts of a session that you may want to 
save to a file. 


When the Holding Buffer is OPEN, data sent to Pacterm and appearing in the 
Viewing area of the Terminal Screen will be added to whatever has already been 
stored in the Holding Buffer. While the Holding Buffer is CLOSED no new data 
can be added, but what is already stored there stays until you clear it, save it, or 
exit Pacterm. 
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+ Hint: When the Holding Buffer is OPEN but full, Pacterm will automatically 
CLOSE it if there is an attempt to add any more data to it. This means that once it 
is full, the Holding Buffer will not be able to accept any more data during the 
current session until it is cleared or saved. 


When the Holding Buffer is OPEN, the term BUFF appears on the Status Line of 
the Terminal Screen. 


ALT+C = Holding Buffer: CLEAR 


Press the ALT+C key combination to CLEAR (delete) the current contents of the 
Holding Buffer, whether it is currently open or closed. 


Caution: This command takes effect immediately and it cannot be undone, so be 
sure you want to CLEAR the Holding Buffer before you use this command. 


F2 = Holding Buffer: SAVE and CLEAR 


Press F2 to SAVE the current contents of the Holding Buffer to a file in the cur- 
rent directory (or to the current directory of a designated drive, if you include a 
drive name with the file) and then automatically CLEAR the Holding Buffer. 


You will be asked to supply a name for the file, using the standard DOS file name 
conventions, and press ENTER to initiate the SAVE operation. 


You may also include a drive name, along with the file name, to save the file in 
the current directory on a drive other than the current drive. The drive name is in- 
cluded in the 14 characters available for the name (e.g., add “C:” to the beginning 
of the file name to store the file in the current directory of drive C). 
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+ Hint: Give the file name fairly promptly (e.g., within a minute or less). This is 
because as soon as you ask to SAVE the Holding Buffer contents, Pacterm will 
automatically STOP the flow of data from the TNC (turn RTS OFF), so you can 
enter a file name and SAVE the current contents of the Holding Buffer without 
losing any data from the TNC. During this time, new data are stored in the TNC’s 
temporary buffer, and when this buffer is full the TNC will not accept further in- 
coming data. After the Holding Buffer has been saved, Pacterm will automati- 
cally enable the flow of data from the TNC (RTS ON, unless Pacterm’s F6 
control is set to STOP) and the TNC will send the contents of its temporary 
buffer to Pacterm before sending new data. 


If you enter an invalid file name, or if the Holding Buffer is empty, Pacterm will 
notify you so you can return to the Terminal Screen. 


Caution: If the drive where you try to SAVE the Holding Buffer contents does 
not have enough space available to save the file, or if the drive door is open, you 
will get the standard DOS message: “Not ready reading drive (n): Abort, Retry, 
Fail?” If you can fix the problem (e.g., shut the door or insert a disk with enough 
space, if you are saving to a floppy drive), do so, type R (for Retry) and press the 
Enter key. To withdraw the SAVE request, type F (for Fail) and press the Enter 
key. If you type A (for Abort) and press the Enter key, you will EXIT to DOS, 
which means the Holding Buffer will be cleared without being saved. 


Caution: If you enter a valid DOS file name, Pacterm will use it without check- 
ing to see if you already have a file by that name in the current directory (or in the 
current directory of a designated drive, if you include a drive name with the file). 
Be careful not to use a file name already in use, unless you want to write the new 
file in place of the old one. 


Two ways to Save Holding Buffer Data 
There are two ways to save the current data: 


e Binary file: To save the data without making any changes to it (e.g., to 
save a downloaded binary file), give the extension “BIN”, for “binary,” 
as part of the file name. 
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e  =6Text file: If the file does not have the BIN extension, Pacterm: 
(1) removes all control characters except those for carriage returns and 
tabs, (2) adds line-feeds to carriage returns, so text will flow from line to 
line rather than overwriting the same line again and again with each 
carriage return, and (3) adds additional carriage returns and line feed 
characters where needed to force the material to “wrap” appropriately 
when it is displayed on a screen (after 75 or 80 characters, depending on 
whether or not there is a space character at the beginning of a given line). 
Note that since the backspace control character, used to backup and 
overwrite typing errors before sending data, will be filtered out, both 
original and corrected characters will remain in the data that are saved. 


Technical note: In both cases, Pacterm will add an “End of File” (EOF) code 
(CTRL+Z) at the end of the data from the Holding Buffer. 


ALT+F = Send a File to Your TNC 


You can use Pacterm to send a file from your computer to your TNC, which is 
then responsible for sending it on to your transceiver for transmission: 


1. Use Pacterm to put your TNC in either Conversation Mode or Transparent 
Mode connection with another station. In Conversation Mode, control char- 
acters are interpreted as commands rather than as data. If you are sending a 
text file for transmission by your TNC, you may wish to have the TNC in 
Conversation Mode. If you want all control characters passed through as 
data, use Transparent Mode. Do not have your TNC in Command Mode, 
since it would then interpret data being sent to it by Pacterm as commands. 


2. After setting up your TNC to handle the file it is going to receive from 
Pacterm, press the ALT+F key combination to start the SEND file operation. 


3. Pacterm will put a small square marker in the data-input area of the Terminal 
Screen and wait for you to enter a DOS file name. Type the file name. Do not 
include any blanks before or after the file name. 


+ Hint: Ifthe file is in the current directory on a drive other than the current drive, 
include the drive name (e.g., C:) before the file name. 
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4. Press the ALT+F key combination again to ENTER the name. Pacterm will 
respond by (1) putting another small square marker on the screen right after 
the file name, (2) locating the file, and (3) sending a copy of it to the TNC. 


Caution: If you give a file name that Pacterm cannot find, that is illegal, or 


that is bounded by any blanks, Pacterm will not respond to the second ALT+F 
command, so nothing will happen. Try again, starting with Step 2. 


5. Ifyour TNC is in Conversation Mode (but not if it is in Transparent Mode) 
and it is set to ECHO, data will be echoed to the Terminal Screen. 


Caution: Sending continues until Pacterm finds an end-of-file code. If the 
file does not have an EOF code (CTRL+2Z), some or all of the file will be sent 


and resent until you EXIT to DOS to end the current session. To send such a 
file successfully, add an EOF code (e.g., by using an appropriate word pro- 
cessor). 


Commands: Exiting 


The following exit commands are available in Pacterm: 


F9 = Switch Your TNC to Command Mode 


From either the MAIN Menu Screen or the Terminal Screen, press the F9 key to 
switch your TNC from Conversation Mode or Transparent Mode communication 
to Command Mode (for the NEWUSER or TERMINAL Interface Mode, which- 
ever your TNC is in at the time). Once in Command Mode, the TNC will inter- 
pret data from Pacterm as being commands to carry out, not as data to transmit. 


Technical note: Pacterm forces this switch by sending the TNC a specially timed 
sequence of three CTRL+Cs (see TNC documentation for details). 


When you use F9 to exit from Conversation or Transparent Mode to the Com- 
mand Mode, the “cmd:” prompt will be appear in the viewing area of the Termi- 
nal Screen. If you are already in Command Mode, using F9 has no effect. 
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F10 = Disconnect and EXIT to DOS 


From either the MAIN Menu Screen or the Terminal Screen, press F10 to 
disconnect from a current connection that may have been established by the 
TNC, EXIT Pacterm and go to DOS. 


Pressing F10 sends the command sequence “CTRL+C, CTRL+C, CTRL+C, D” 
to the TNC before exiting to DOS. The sequence of three CTRL+Cs in quick 
succession changes the TNC to Command Mode if it was not already in Com- 
mand Mode, and the D is a short form of the DISCONNECT command. 


Caution: If there is no connection at the time, the TNC will report this fact, but 
you will not see this report at the time, since you will EXIT Pacterm immediately. 
You may see this message (“Can’t disconnect...) when you start Pacterm again, 
since it will have been stored in the TNC’s temporary buffer, waiting to be sent at 
the beginning of a new Pacterm session. 


+ Hint: If your TNC is turned OFF when you press F10, your computer may freeze 
up when these commands are sent by Pacterm. Try turning the TNC back ON and 
using F10 again to EXIT. If there is no response, just reboot your computer and 
start another Pacterm session. 


ESC or CTRL+C (on Main Menu Only) = EXIT to DOS 


From the MAIN Menu, you can EXIT directly to DOS by pressing the ESC key 
or by pressing the CTRL+C key combination. 


When you are on the Terminal Screen, you cannot EXIT to DOS by pressing 
ESC or CTRL+C. This is because at this time these are legal characters that can 
be sent to the TNC, so they will just be added to the data stream. In Transparent 
mode, each of these control characters will display as a graphic character in the 
data shown on the Terminal Screen. 


+ Hint: From the Terminal Screen, you may press F10 to Disconnect and EXIT to 
DOS or use F1 to go to the MAIN Menu, from where you can use ESC, 
CTRL4C, or F10, to EXIT to DOS. 
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HF Non-Packet Functions (For KAMs Only) 


This section is not relevant to TNC users. It is included as part of a full descrip- 
tion of Pacterm and as brief documentation for users of Kantronics’ KAM TNCs 
with the following HF non-packet modes: 


e RITY 

e §6ASCII 

e AMTOR 
e PACTOR 
e G-TOR 

e CW 


As noted above, pressing F3 switches Pacterm between use with Packet and use 
with HF Non-Packet. 


+ Hint: When Pacterm is set to work with HF non-packet modes of communica- 
tion, you can send a CTRL+C code to the TNC either by using the appropriate 
Pacterm function or by entering the CTRL+C key sequence from the keyboard. 


Commands that Work Differently in HF Non-Packet Mode 


When Pacterm is in HF non-packet mode, the following commands have an ““X” 
added to the string of characters they send to the TNC: 


e F9 = Goto “Command Mode.” 


+ Hint: To change from one HF Non-Packet mode to another, you need to 
return to the TNC’s Command Mode, so your TNC will be able to accept 
the command for the next HF non-packet mode. You can do this without 
using F3 to switch to Packet mode, if you are just switching from one HF 
non-packet mode to another. If you do want to switch to Packet use of 
your TNC, press F9 to go to Command Mode, then F3 to switch to 
Packet use of your TNC. 


e F10= Disconnect (Break Link) and Exit to DOS. 
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Additional Commands for HF Non-Packet 


The commands listed below are only available during HF Non-Packet use of the 
TNC (and only then are they shown on the Main Menu screen, in a box in the 
lower right of the screen). 


ALT+T (transmit) = Exit Type-ahead 


This command can be used with all the HF Non-Packet modes listed above. 


ALT+T sends a CTRL+C T CTRL+M sequence to the TNC. This causes the 
TNC to key the radio and transmit the data in the TNC’s buffer. And if the F5 
command had been used to put Pacterm in the type-ahead mode (offline), the sta- 
tus line will change to show Pacterm as online (ONLIN). 


ALT+R (receive) = Return to Type-ahead 


This command can be used with all the HF Non-Packet modes listed above. 


ALT+R sends a CTRL+C R sequence to the TNC. This will immediately return 
the TNC to the receive mode, even if there is still data in its transmit buffer. Data 
in the TNC’s transmit buffer will be saved for transmission later. 


+ Hint: See ALT+E if you want to transmit all data in the TNC and then switch to 
receive mode. 


ALT+E = Return to Receive 


This command can be used with all the HF Non-Packet modes listed above. 


ALT+R sends a CTRL+C E sequence to the TNC. This will allow the data in 
the TNC transmit buffer to be sent and then return the TNC to receive mode. 


+ Hint: Used ALT+R when you want to hold the data in the TNC transmit buffer 
and return the TNC to receive mode. 
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ALT+H = Shift Tone Pair Frequencies 


This command can be used with the following HF Non-Packet modes: RTTY, 
ASCH, and AMTOR. 


ALT+H sends a CTRL+C S sequence to the TNC. This command changes shifts 
in RTTY, ASCH, and AMTOR modes. 


ALT+I = Invert Received Signal (rtty/ascii) 


This command can be used with the following HF Non-Packet modes: RTTY, 
ASCH, and AMTOR. 


ALT+I sends a CTRL+C I sequence to the TNC. This command inverts the 
received signal in RTTY, ASCII and AMTOR modes. 


ALT+S n = Speed Change 


This command can be used with the following HF Non-Packet modes: RTTY, 
ASCH, and CW. 


ALT+S n sends a CTRL+C n sequence to the TNC, where n is a number from 0 
to 9. This command lets you change the speed at which you will transmit in 
RTTY, ASCII or CW modes. 


In RTTY or ASCII mode, n selects the nth item on the TNC’s list of 

9 pre-programmed speeds. Use the value of n = 0 to change to the current value 
of RBAUD or ASCBAUD, which may or may not be set to the default value 
(default values are: RBAUD = 45, ASCBAUD = 110). 


In CW mode, ALT+S n sets the transmit speed to 5*n words-per-minute 

(e.g., ALT+S 3 = 5*3 = 15 words-per-minute). In CW mode, use n = 0 to set the 
transmit speed to 50 words-per-minute (0 is interpreted as = 10, yielding 

5*10 = 50 words-per-minute). 
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Trouble-Shooting Difficulties in Communicating 


If you are having difficulty establishing and maintaining communication between 
Pacterm and your TNC, here are some points to consider in addition to those cov- 
ered on the “Pacterm Cannot Communicate” screen. 


Problem: Go to Terminal Screen, but Nothing Happens 


One possibility is that the current COM port does have a device on it, but it is not 
a TNC. It might be a mouse or an internal phone modem, for example. To see if it 
is a mouse, go to the TERMINAL Screen, start moving your mouse and see if se- 
quences of characters appear as you move the mouse. If so, change the COM port 
setting in Pacterm and try again. 


Problem: Your Computer Freezes Up 


When Pacterm gets the go-ahead signal for communicating, it will act on the 
assumption that the signal is from your TNC. There is no way Pacterm can verify 
that the signal is actually coming from your TNC and not from another 

device on the current COM port (e.g., a mouse, or an internal phone modem). 

So if the device on the current COM port is not a TNC, Pacterm will be running 
under a misunderstanding and, in this case, your computer may “freeze-up,” 
requiring you to turn it off, re-start it, and take steps to correct the problem before 
running Pacterm again. 


Problem: You Are Getting Bad or Intermittent Data 


Many PC compatible computers are designed with a built-in potential conflict 
that may cause a problem: Both COM2 and COM4 (and both COM1 and COM3) 
may use the same interrupt (IRQ) mechanism to get the attention of the computer. 
This means that if devices on both COM2 and COM4 (or both COM1 and 
COMS3) are sending signals to the computer at the same time, this can cause 
problems for programs, such as Pacterm, that use either COM port. If you are 
getting bad data, check to see if you have another device that might be getting 
confused with your TNC (on COM4 if your TNC is on COM2; COM3 if your 
TNC is on COM1) and make it inactive or remove it while using Pacterm with 
your TNC. 
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Problem: Your TNC Stops Behaving Normally 


Pacterm is intended for use with a TNC in NEWUSER or TERMINAL Interface 
Mode (or, less often, in BBS or GPS Interface Mode), but it may receive data 
from the TNC in any Interface Mode. Non-response, garbled data, or partially 
garbled data may indicate the TNC has been switched to HOST or KISS mode 
and needs to be switched back to NEWUSER or TERMINAL. See the TNC doc- 
umentation for instructions on how to determine what Interface Mode your TNC 
is in currently and how to change it to the Interface Mode you want (NEWUSER 
or TERMINAL). 


User's Guide 88 KPC-3 Plus v 8.2 


Getting Started 


This chapter gives you important information and examples to get you started 
using your packet radio station. 


We assume you have installed your station and familiarized yourself with the use 
of Pacterm with your KPC-3 Plus, as covered in the chapters on “Installing your 
KPC-3 Plus” and “Pacterm.” 


Hint: If you are familiar with other communication software, you may use it in- 
stead of Pacterm. In this case, you need to be aware that Kantronics’ documenta- 
tion and support services assume the use of Pacterm, at least for getting started. 

If you have not yet installed your station, including Pacterm communication 
software, and learned how to use Pacterm, we suggest that you do so before con- 
tinuing with this chapter. 


Material covered here includes diagrams, explanations, and mini-tutorials on: 
e the front panel of the KPC-3 Plus, 
e beginning a session, 
e¢ giving commands and transmitting data, 
e =the 22 NEWUSER commands that you will be using most of the time, 
e using selected NEWUSER commands, 
e using the Personal Bulletin Board System that is in your KPC-3 Plus, 
e¢ monitoring transmissions from nearby packet radio stations, and 
¢ connecting to another station and initiating a conversation. 


+ Reading this chapter (or just skimming the material, if you are already familiar 
with the topics) will also help you use the following chapters on different modes 
of use of the KPC-3 Plus, the “Command Reference” chapter, and any 
appendices that are relevant to your needs. 
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The Front Panel of the KPC-3 Plus 


You have already used the POWER switch on the KPC-3 Plus to turn power on 
and off. This is a good time to get familiar with all the indicators on the front 
panel of the KPC-3 Plus. 


The following diagram shows the placement and function of the controls and in- 
dicators on the front of your KPC-3 Plus, as well as a brief explanation of each: 


KPC-3 Plus -- Front Panel 


Kantronics PacketCommunicator 3 Plus 
|| Power Xmit Rev Con Sta Mail 

So FP ATS 
f wae Fal 


Power Transm it Connected Mailbox 
Po wer switch Red LED isON Green LED isON when Yellow LED is ON 
(push in to tum when your INC your INC hasa packet when there isa 
powerON, push is sending a connection on the packet connection 
in again to tum packet signal to current stream to your INC's 
power OFF) your transc eiver mailbox (ie., PBBS) 
Green LED isON . Sta tus Yellow LED BLINKS 
when your INC Receive Green LED is ON when when there is 
is tumed on and Green LED isON your INC has atleastone unread mail foryou 
receiving power when your INC unacknowledged packet in your PBBS and 
is receiving a on the Curent stream there is Currently no 
signal from your (ie., a packet thatwas packet connection 
transceiver transmitted to another station to your PBBS 


has not been acknowledged 


ora packetis cued for transmission 
Note: There is also a INC command to another station) 


to turn OFF all the LED displays. 


© Copyright 1997 by Kantronics, Inc 
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Beginning a Session 


The steps involved in starting a session are covered in the “Pacterm” chapter, so 
they do not need to be repeated here. 


Recall that you need to turn on your KPC-3 Plus and start Pacterm (which runs in 
your computer and provides you with a way to communicate with the KPC-3 Plus). 


Once your initial setup is completed (including giving a CALLSIGN to your 
KPC-3 Plus and setting other parameters as needed), the first thing you will see 
each time you start a new session is a sign-on message from the KPC-3 Plus 
(sent to Pacterm and displayed on your computer screen) such as the following: 


KANTRONICS PACKET CONTROLLER III PLUS VERSION 8.2 
(C) COPYRIGHT 1988-1997 BY KANTRONICS INC. ALL RIGHTS RESERVED. 
DUPLICATION PROHIBITED WITHOUT PERMISSION OF KANTRONICS. 


cmd: 


The last line of this message (“cmd:”) is the KPC-3 Plus’s report that it is now in 
“Command” mode, which means that it is now expecting information from 
Pacterm to be commands for it (the KPC-3 Plus) to interpret and carry out. 


Before learning about the specific commands you can give the KPC-3 Plus, it is 


important to keep in mind the difference between giving the KPC-3 Plus com- 
mands and giving the KPC-3 Plus data that is to be transmitted. 


Giving Commands and Transmitting Data 


The KPC-3 Plus will react to data received from Pacterm (or any other source) 
either as a command to follow or as information to transmit. 


Command Mode 


When in the “COMMAND” mode of communication, the KPC-3 Plus will 
interpret data received from Pacterm (or any other source) as being a command 
to process, not as data to transmit. To instruct your KPC-3 Plus to connect, to 
disconnect, or to change any of the operating parameters in the KPC-3 Plus you 
must be in the COMMAND mode. 


+ When placed in COMMAND mode (and ready to receive the next command) the 
KPC-3 sends a “cmd:” prompt for display on the computer’s screen. 
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Converse (Conversation) Mode 


When in “CONVERS” (conversation) mode, the KPC-3 will interpret data re- 
ceived from Pacterm (or any other source) as data to transmit. In “CONVERS” 
mode, the KPC-3 Plus interprets most characters as information to be transmit- 
ted, while interpreting certain pre-defined characters (which the user can change) 
as control characters rather than as data to be sent. For example, a “backspace” 
character causes a backspace and is not transmitted. 


+ The KPC-3 Plus will automatically switch to the CONVERS mode for you when 
you connect to someone or when someone connects to you and will return to the 
COMMAND mode when a disconnect occurs. When you are in COMMAND 
mode, you may switch to CONVERS mode just by giving the command K 

(or CONVERS). If you are in the CONVERS mode and want to force your 
KPC-3 Plus back to the COMMAND mode, you type a <Ctrl+C>. 


TRANS (Transparent) Mode 


A second way to transmit data is to instruct the KPC-3 Plus to ignore the “control 
characters” (e.g., “backspace”’) and just transmit every character as data. This is 
called the “TRANS” (transparent) mode of communication. For example, if data 
received by the KPC-3 Plus for transmission in TRANS mode includes “back- 
space” characters (i.e., characters that would cause a backspace in CONVERS 
mode), the KPC-3 Plus will transmit the backspace characters as part of the data. 


+ Before you can switch to TRANS mode, you need to set INTFACE to 
TERMINAL instead of NEWUSER. (This is because, as described in the next 
section, the TRANS command is not a NEWUSER command.) To get out of 
TRANS mode and back to COMMAND mode, enter “<Ctrl+C> three times, with 
a pause of less than one second between each entry. 


NEWUSER Commands and All the Commands 


You have a choice of whether to have your KPC-3 Plus prepared to deal with a 
small set of (22) NEWUSER commands (which is the default setting) or with the 
full set of over 130 commands it is capable of carrying out. 


+ Note: To switch to the full command set of the KPC-3 Plus, get in COMMAND 
Mode (<Ctrl+C> or press F9 in Pacterm) and give the command INTFACE TER- 
MINAL. To switch back, give the command INTFACE NEWUSER. 
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Diagram of NEWUSER Commands 


The diagram below groups the NEWUSER commands and summarizes 
each command. 


NEWUSER Commands 


NEWUSER commands are a subset of the full TERMINAL command set. NEWUSER commands are all you 


need for basic, beginner operations of your packet radio station. These commands are explained in the 
Command Reference section of the manual. 


Select the current interface mode 


INTFACE: Set the current interface mode to NEWUSER, TERMINAL, BBS, HOST, KISS, XKISS, GPS 
or MODEM. Default is NEWUSER, which makes available just the basic commands listed here. 


Get help and other information about your KPC-3 Plus 

HELP: List all available commands or a brief description of a specified command. 
DISPLAY: Show current values for all parameters or for a specified group of parameters. 
VERSION: Show the version number of the EPROM (firmware) installed in your KPC-3 Plus. 


( : 
Configure your KPC-3 Plus Configure your personal mailbox (PBBS) 
RESEE pen acres eves MYPBBS: Change the callsign of your PBBS. 
OFF, then ON again (‘soft reset"). PBBS: Change the size of your PBBS (1.e., RAM used). 
MYCALL: Change your KPC-3 Plus's callsign. 


DAYTIME: Set your KPC-3 Plus's software (and optional hardware) clock. 
TXDELAY: Set the transmitter key-up delay (default is 300 ms). 
DWAIT: Time delay imposed to insure that digipeaters have priority access to the radio frequency. 


Define your KPC-3 Plus's use of characters sent to it from your computer 
ECHO: Display characters you type (default is ON, for use with full duplex communication programs). 
BKONDEL: Select the effect of entering a "delete" (i.e., erase the previous character or display a "\"). 
DELETE: Change which key your KPC-3 Plus will interpret as "delete" (default is backspace key). 


x 


( Display communication activity 

MONITOR: Display packets from other stations (default is ON). 

STATUS: Display current I/O stream and link status of other connected streams. 
| MHEARD: Display a list of stations recently heard by your KPC-3 Plus. 


Session control 
CONNECT: Start a session (i.e., connect to a station) and automatically switch to CONVERS Mode. 
DISCONNE: End a session (i.e., disconnect from a station). 


UNPROTO: Set a destination and digipeater path for unproto packet transmissions. 


Switch from giving your KPC-3 Plus commands to using it to send data 


CONVERS: Switch from COMMAND communication mode to CONVERS (i.e., conversation) 


Mode. The default way to go back to COMMAND Mode is to enter <Ctrl+C>. 
Kk: Same as CONVERS. 
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List of NEWUSER Commands 
The following is an alphabetical listing of the 22 NEWUSER commands and a 
brief description of each. 


BKONDEL - When ON echoes a backspace-space-backspace sequence to the 
screen each time you press the DELETE key to erase errors from your screen. 
When OFF, echoes a \ for each press of the DELETE key. 


CONNECT - Used to establish a packet connection with another station. 
CONVERS - Places the KPC-3 Plus in CONVERS mode. 

DISCONNE - Used to disconnect from a station you have been talking to. 
DAYTIME - Used to read or set the clock in the KPC-3 Plus. 


DELETE - Determines the character received from the computer which will 
cause the previous character to be removed from the transmit buffer. 


DISPLAY - Causes a screen display of all KPC-3 Plus parameters. 


DWAIT - Time delay imposed to insure that digipeaters have priority access to 
the radio frequency. 


ECHO - When ON characters you type on the keyboard will be echoed back to 
your terminal. When OFF characters you type will not be echoed. 


HELP - Displays a complete list of all available commands on your screen. 


INTFACE - Selects the NEWUSER command set or the complete (TERMINAL) com- 
mand set. Also used to place the KPC-3 Plus in HOST, BBS, KISS, XKISS, 
MODEM or GPS mode. 


K - Switches the KPC-3 Plus into the CONVERS mode (same as CONVERS). 


MONITOR - When ON allows the KPC-3 Plus to display monitored packets on 
the screen. When OFF, no packets will be displayed unless someone actually 
connects to you. 


MHEARD - Displays a short list of stations that have recently been heard by 
your KPC-3 Plus. 


MYCALL - Used to set the callsign of your KPC-3 Plus. 

MYPBBS - Sets the callsign used for your personal mailbox in the KPC-3 Plus. 
PBBS - Used to set the size (Kbytes) of the Personal BBS in your KPC-3 Plus. 
RESET - Causes the KPC-3 Plus to perform a soft reset. 


STATUS - Displays the status of the current stream and all connected streams. 
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TXDELAY - Sets the time delay between Push-to-Talk and the beginning of data. 


UNPROTO - Sets the destination field and digipeaters used for any unconnected 
data packets transmitted. 


VERSION - Displays the current version number of the EPROM (firmware) in 
your KPC-3 Plus. 


Using NEWUSER Commands 


A brief look at the use of selected NEWUSER commands will give you the fa- 
miliarity you need to continue on your own using KPC-3 Plus commands. 


Check Your KPC-3 Plus’s Version Number and ID 


To check your KPC-3 Plus’s version number and ID all you need to do is ask to 
see the current setting of the command called VERSION: 


Step 1. Go to COMMAND mode (if you are not already there). 
Step 2. Type “VERSION?” (or the short form, ““V”’) and press the 
ENTER key to enter the command. 


Step 3. The KPC-3 Plus will send it’s version number and other 
ID information for display on your monitor. 


Get Help 
To see a one-line explanation of any command that is currently available: 
Step 1. Go to COMMAND mode (if you are not already there). 
Step 2. Type “HELP,” (or “‘?”’) followed by one or more spaces 


and the name of the command for which you want help. 


Step 3. The KPC-3 Plus will send a short “HELP” message 
about the command, for display on your monitor. 
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View Current Values of Parameters 


To see the current value of parameter(s) for any variable (other than the “immedi- 
ate” commands, like CONVERS, that are simple actions, not settings): 


Step 1. Go to COMMAND mode, as described above (if you are 
not already there). 
Step 2. Type the name of the command for which you want to 


see current parameter value(s). 


Step 3. The KPC-3 Plus will send a message consisting of the 
name of the command and the value(s) of it’s parameters 
for display on your monitor. For example, if you type 
INTFACE, you will see INTFACE NEWUSER if you 
are currently in the NEWUSER mode. 


+ As explained in the “Command Reference” chapter, the DISPLAY command 
can be used to see current values of selected sub-sets of commands. 


Change the Value of a Parameter 


To change the current value of parameter(s) for any variable (other than the “im- 
mediate” commands, like CONVERS, that are simple actions, not settings): 


Step 1. Go to COMMAND mode, as described above (if you are 
not already there). 


Step 2. Type the name of the command for which you want to 
change the current parameter value(s), type one or more 
spaces, and enter the new value(s) you want for the pa- 
rameter(s) for the command. 


Step 3. The KPC-3 Plus will immediately change the value(s) to 
the values(s) you have just entered. 


+ Ifyou enter a value that is not possible (e.g., INTFACE MOON), you will get 
an error message (“EH?”). 


To confirm that the current value(s) is what you want, enter the name of the com- 
mand and press ENTER, The KPC-3 Plus will send a message consisting of the 
name of the command and the current value(s) of it’s parameters for display on 
your monitor. 
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Connect to Your Mailbox 


+ 


You are now ready to try your first connect. 


A good first connect (which also shows you an important part of your KPC-3 
Plus), is to simply connect to your own personal mailbox, built in to the KPC-3 
Plus: 


This is an internal connect, so your radio does not need to be connected to do it. 


Step 1. Go to COMMAND mode (if you are not already there), 
where you will see the “cmd:” prompt. 


Step 2. Type CONNECT call (where “call” is your MYPBBS) 
and press the ENTER (return) key to enter the command. 
By default, MYPBBS is the callsign you entered right 
after the autobaud routine, with “-1" appended to it. 


Note: To see the current mailbox callsign, type MYPBBS and press the ENTER 
(return) key. The callsign shown in the one to use when connecting to your 
mailbox (PBBS) 


Step 3. Your KPC-3 Plus will connect you to the mailbox. Your 
screen should look something like this: 


cmd:CONNECT N@KN-1 

cmd:*** CONNECTED to N@KN-1 
[KPC3P-8.2-HMS ] 
5000 BYTES AVAILABLE 

ENTER COMMAND: B,J,K,L,R,S, or 


Help> 
+ The commands now shown as available are just for the mailbox. The KPC-3 


Plus’s NEWUSER (and TERMINAL) commands become available again 
when you exit the mailbox. 


Step 4. Now you can give any of the mailbox commands shown 
(B,J,K,L,R,S, or Help). Later you will want to read the 
“PBBS (Personal Mailbox) section of the “Modes of 
Operation” chapter for more details. 


If you now type the HELP command and press return, 
you'll see the KPC-3 Plus mailbox help file and then the 
standard mailbox prompt: 
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Step 5. 


Help> 


Monitor Communications From Nearby 


ENTER COMMAND: B,J,K,L,R,S, or 


Now disconnect (just like you will disconnect from any 
other user). 

First, return to command mode by typing a <Ctrl+C> on 
your keyboard. To do this, hold down the control key 
(usually marked Ctrl) and type the letter C. Then let go 
of the control key. 


You should now see the “cmd:” prompt. 
Next type the DISCONNE command and press return. 


You will receive the message *** DISCONNECTED 
and a new command prompt. 


Congratulations. You have now completed your first connect. 


Monitor Communications From Nearby Stations 


A good way to start using your packet radio station is to monitor communications 
from nearby stations. 


+ Amateur packet-radio activity is usually at VHF, on 2 meters, with 145.010 MHz 
being the most common packet-radio frequency. The most common baud rate 


is 1200. 


To monitor communications from nearby stations (after you have tuned in to an 
appropriate frequency): 


Step 1. 
Step 2. 


Step 3. 


Set MONITOR to ON (if it is not already ON). 
Disconnect from any other station (or mailbox). 


As packets are received, you will see them displayed on 
your screen. A typical received packet might look like 
this: 

NOKN>KBONYK: 

Hi Mike. How are you today? 


The first line is the header line, and shows the callsigns 
of the stations talking and the following line(s) are the 
actual message that was sent. In the example, NOKN is 
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the transmitting station, and KBONYK is the receiving 
station. You may see the RCV LED light at times, indi- 
cating a signal is being received, but nothing displays on 
your screen. This is normal and may be the result of the 
settings of the monitoring commands which are dis- 
cussed in detail in the KPC-3 Plus Command Reference. 


As you monitor, you will begin to learn about other packet stations in your area 
and then you will probably want to try to connect to one of them. 


Communicate Directly with a Nearby Station 


Now you are ready to carry on a two-way conversation with another station. Here 
we will see exactly what you need to do to connect to and converse with another 


station. 


Let’s say that you decide to connect to KBONYK. The steps needed are as fol- 


lows: 


Step 1. 


Step 2. 


First, be sure you have the KPC-3 Plus in command 
mode. To do this, type <Ctrl+C> and then press return. 
You should see a command prompt (cmd:). 


Now you use the CONNECT command. To connect to 
KBONYK, you would simply type CONNECT 
KBONYK and press return, just as you did in the sample 
connect to your mailbox. 


+ Insome cases you may need to use a relay station (called a digipeater) to con- 
tact another station. This is similar to using a voice repeater when the station 
you want to talk to is out of simplex range. To connect to a station using 
digipeaters, you still use the CONNECT command, but you must also specify 
the callsigns (or aliases) of the digipeaters that must be used. For instance, if 
you need to use two digipeaters with callsigns of WOXI and NOGRG in order 
to connect to KBONYK, you would give the connect command as “CON- 
NECT KBONYK VIA WOXI,N@GRG” 


Step 3. 


Once the connection has been made, you’ll receive a 
message back on your screen from the KPC-3 Plus that 
says *** CONNECTED to KBONYK (or, if you are us- 
ing relay stations, *** CONNECTED to KBONYK via 
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Step 4. 


Communicate Directly with a Nearby Station 


WOXI,NOGRG). At that point you are ready to start 
talking to the other station since the KPC-3 Plus has al- 
ready automatically switched into the CONVERS mode. 


After you have completed your conversation, simply 
press <Ctrl+C> to return your KPC-3 Plus to the com- 
mand mode (“cmd:” will be displayed) and then you can 
instruct your KPC-3 Plus to disconnect as you did above 
with the mailbox, by entering D (or the full form, 
DISCONNE) and return. 


As you begin working with your KPC-3 Plus packet radio station, other topics 
that you may wish to explore (with the help of other sections of this manual) in- 


clude: 


doing hard and soft resets, 
communicating via relays with a distant station, 
using network nodes, and 


working with a GPS device. 


This concludes a quick tour of basic uses of your KPC-3 Plus. With just these ba- 
sics, you can do a lot, but you have a great deal more power if you want to ex- 
plore the full possibilities. 


For more information on all the topics we have covered here, and more, see the 
following chapters in this manual. 
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This chapter covers the major ways in which you may use your Kantronics TNC. 
For details on particular commands, see the “Command Reference” chapter. 


Packet Mode of Operation 


This section adds to the information presented earlier (in the Getting Started and 
other sections) on how packet radio uses digital information for communication. 
By familiarizing yourself with the concepts presented here, you’ll be aware of 
and, if you wish, able to change the default value(s) of the command parameters 
in your TNC to optimize your packet activities. 


Introduction 


Information is Organized into “Packets” 


A packet is a group of characters with a flag and header at the beginning and a 
checksum and flag at the end. A flag is a specific character used to signify the be- 
ginning and ending of a packet. The header is information indicating who the 
packet is from, who it is to, any relay stations needed to get to the destination and 
some control information. A checksum is a complicated mathematical formula 
that produces a number based on the combination of characters that are in the 
packet. This number is recalculated by every station that receives the packet and 
if it does not match the number that is in the packet, the packet is thrown away, 
thus near error-free communications. A packet is also called a frame. 


Your Packet Unit is a Terminal Node Controller (TNC) 


Packet radio modems, or packet modems, are generally referred to as TNCs. This 
“label” or “moniker” was adopted when the Tucson Area Packet Radio Group 
(TAPR) developed their first “TNC-1" packet radio modem kit in the early 
1980s. The TNC is the workhorse of packet radio. As a listening device it hears 
an audio signal from the radio, changes the data to digital form, determines if the 
data is a good packet and sends it to whatever device is attached, usually a com- 
puter. As a relay device it also checks the packets it receives and determines if 
the packets need to be resent, then does so if appropriate. As a sending device it 
receives digital data from the computer, packetizes it and changes it into audio 
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tones which are sent out to the radio. The rules the TNC uses to do all of this is 
called a protocol. 


Protocol for Amateur Packet Radio: AX.25 


The most commonly used protocol in amateur packet radio is AX.25. The details 
of the inner workings can be found in a book titled “AX.25 Amateur 
Packet-Radio Link-Layer Protocol’, which is available from the ARRL. Most 
TNC users will not need to or care to go into the details. The TNC takes care of 
the nitty gritty work for you, although there are parameters you can set that deter- 
mine how efficiently some of that work is done. 


Command Mode 


In order to change parameters, or give any other instructions to the TNC, you 
must be in Command Mode. This is the mode you will be in when you first turn 
on the TNC or after resetting it. 


Once you have left Command Mode for any reason, there is a parameter called 
COMMAND that determines what special character you will use to return to 
Command Mode. This comes defaulted as a <Ctrl+C> (i.e., while holding down 
the control key, press “C”’, then release both keys). 


Whenever you enter Command Mode the TNC will send a prompt to your screen 
that looks like this: 


cmd: 


Connected vs Unproto 


There are two ways to send data in packet radio, connected or unproto (uncon- 
nected). In the Connected Mode you first establish a connection. Then your TNC 
will send packets to that specific station and expects acknowledgments in return. 
If an acknowledgment is not received, the TNC will resend the data (depending 
on the setting of AX25L2V2, it may send a poll first). The RETRY parameter 
will determine how many times this is done before the connection is lost due to 
bad conditions. If the acknowledgment is received, the TNC is happy and will 
send more data when available. Therefore the Connected Mode, barring impossi- 
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ble conditions, assures that the station you are connected to will receive every- 
thing you say, and in the order you say it. 


In the Unproto Mode, when your TNC sends a packet, no acknowledgment is ex- 
pected and no retries are attempted. This mode is often used for calling CQ, for 
transmitting beacons, and for informal round table chats. 


Monitoring and Calling CQ 


If you turn the MONITOR command ON, you will see other people’s packets on 
your screen. You will notice two callsigns at the beginning of each packet sepa- 
rated by a “>”. The first callsign is the station the packet is from, and the second 
callsign is the station the packet is to. An Unproto packet may have a name or 
CQ for the second callsign. 


To set what will be seen as the “to” callsign for Unproto packets you send, you 
use the UNPROTO command. This comes defaulted as CQ. 


In order to call CQ you must get into the Convers Mode, so that what you are 
typing to the TNC will be interpreted as data to be sent out on the air and not as 
commands. To do this type: 


K<CR> 


Now anything you type will be packetized and sent out on the air. Remember to 
get back to Command Mode you enter a <Ctrl+C> (default) by holding down the 
Control key while pressing “C”. You will be going between Command and 
Convers Modes depending on whether you want to talk to the TNC or have the 
TNC packetize what you type to go out on the air. 


A Simple Connect 
Once you see a station you would like to connect to, be sure you are in Command 
Mode, and issue a connect request. For example: 
C callsign<CR> 


where C is short for CONNECT and callsign is the callsign of the station you 
wish to connect to. 
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If for any reason the connection fails, the TNC will send the following message 
to your screen: 


*** RETRY COUNT EXCEEDED 
*** DISCONNECTED 


When your TNC does receive an acknowledgment for a connect packet, it will 
display a message on your screen like: 


*** CONNECTED TO callsign 


and your TNC will change to the Convers Mode (dependent on the setting of 
NOMODE and CONMODE). Now what you type will be interpreted by the TNC 
as data to be sent to the other station and not commands to the TNC. The MCON 
parameter comes defaulted to OFF. Therefore once you are connected all you will 
see is what you type and what the person connected to you sends you. Any pack- 
ets sent by other people will not be monitored unless they are also connected to 
you on another stream. 


Two things determine when the data you send will be packetized. One is the pa- 
rameter SENDPAC. This is defaulted as the return or ENTER key. So as you are 
typing your message, whenever you hit the return or ENTER key, you are telling 
the TNC to make a new packet. A second parameter, PACLEN, determines the 
maximum length of any packet. If you enter data longer than this length, a packet 
will be made even though you have not pressed the return or ENTER key. 


When you have finished your conversation you need to end the connection. To do 
this you go into the Command Mode and type a “d” for Disconnect. Remember 
to press the return or enter key after any command to the TNC. Once your station 
has received the acknowledgment for the disconnect packet the TNC will send 
this message to your screen: 


*** DISCONNECTED 


Either station can issue the disconnect command, no matter which station origi- 
nated the connect. 
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Digipeating 


Everything we have done so far will only be heard by those within range to hear 
your signal. With packet radio it is possible to go farther than that. The 
DIGIPEAT parameter in the TNC comes defaulted ON. This makes your TNC a 
possible relay station, or digital repeater — digipeater, or just digi for short. In 
many VHF communities one or more of these is put up in a good, high location 
and referred to as a dedicated digi. The TNC and radio is all that is needed for the 
digital repeater to do its job. A computer would be needed if you wanted to 
change a parameter, but it would not need to stay there for the digi to work. The 
higher the antenna, the more effective a digi will be, but remember, every TNC 
has the capability of being a digipeater. 


If we turn the MRPT command ON we will begin to see more than just the 
“from” and “to” stations of the monitored packets. We will also see the callsigns 
of those stations that have been used as digipeaters. This list of stations is often 
called a path. Here is an example of what you might see: 


N@KN>KBONYK, IAH*, LAG, AUS: 
Hi there 


In this example, NOKN is talking to KBONYK, using the digipeaters IAH, LAG 
and AUS. The asterisk beside IAH tells you that you are hearing that digipeater. 
You will notice that [AH, LAG and AUS are not real callsigns. The TNC pro- 
vides a parameter (MYALIAS) to set up an alias, which is often easier to remem- 
ber than a callsign. To make this connection NOKN would have typed the 
following command to his TNC: 


C KB@NYK V IAH, LAG, AUS 


V is short for via and up to 8 digis may be used. You must specify digis in the or- 
der they will be encountered along the path from your station to the station you 
wish to connect to. A space must be typed after the “C” and on both sides of the 
“Vv”, but digis are separated by commas. A path can also be used with the Unproto 
command: 


U CQ V NOM, LCH, SLI, BIX 


Unproto sets up the path for anything that is subsequently typed in the Convers 
Mode where no connection exists. CONNECT issues a connect request to the 
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specified station, via the specified path. Then a virtually error-free conversation 
can take place between them. 


When digipeating, the packet goes all the way from the first station, through all 
relay stations, to the destination station. Then the response also has to take this 
same path in reverse. Chances for collisions and, therefore, for retries are multi- 
plied with every digi used. This is often called end-to-end acknowledgment. An- 
other way to get from one place to another is to connect to a “node”. A node will 
take care of the acknowledgment between it and the next node or end user. See 
the KA-Node section for more information. Ask your local packeteers about 
other types of nodes which may be operational in your area, such as K-Net, 
TheNet, NET/ROM, G8BPQ, and ROSE. 


+  Kantronics TNCs support additional, advanced UI digipeating commands. For a 
description of Kantronics’ UI digipeating commands, see “Advanced GPS (or 
APRS) digipeating”, in the GPS Mode of Operation section of this chapter. 


Gateways 


In Kantronics’ multi-port devices (e.g., Kantronics KAM Plus and KPC-9612 
Plus), a Gateway is also available. 


Using a gateway is similar to digipeating except that the retransmission of the 
packet takes place on another radio port of the TNC other than where it was re- 
ceived. In other words, if you are on VHF and send a packet via a Gateway 
callsign of a KAM, your packet would be retransmitted on HF on whatever fre- 
quency the radio connected to the KAM is set for. When you use one of these 
gateways on HF, remember that on HF the baud rate is slower so you may want 
to lengthen some of your timing parameters. See the KA-Node section for an- 
other way to accomplish this with a more reliable connection. 


Multi-Connects 


The TNC makes it possible for you to talk to more than one person at the same 
time. Single port TNCs such as the KPC-3 Plus support 26 streams on the one 
port. 


+ Multi-port TNCs (e.g., KPC-9612 Plus) support 26 streams per port. 


The command MAXUSERS determines how many streams may be used at one 
time, per port, and the command USERS determines how many people can con- 
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nect to the TNC per port. An incoming connect uses the next available stream. If 
the number of streams set by USERS is full, then a station attempting a connect 
with your TNC will receive a busy message instead of a connect. However, if 
MAXUSERS is set larger than USERS, you can still issue outgoing connects on 
additional streams. 


To determine which port you are on, simply use the STATUS command, typing 
STAT at the command prompt. The TNC will report which streams are active and 
which one you are on. If you wish to remain on the current stream to communi- 
cate, no action is necessary. To change streams ( to make another connect or to 
send data to another station already connected to you) type the STREAMSW 
character, the number of the port (if you are changing ports on a multi-port 
TNC), and the letter designation of the stream you wish to be on. No return or en- 
ter key is necessary. 


For example, let’s assume you are using a KPC-9612 Plus and you are connected 
to WOXI on stream A of port 2 but you wish to return to a discussion with 
N@GRG on stream B of port 1. Whether in command mode or convers mode, 
simply enter “|1b” and the TNC will switch to port 1, stream B. When you do 
this, the CON and STA lights on the front panel will switch with you, reporting 
the status of the new stream. 


If you are connected and have MONITOR or MCON OFF, the normal headers 
containing the “to” and “from” callsigns will not be shown. The setting of 
STREAMEYV will then determine how often you see the stream designator. This 
parameter comes defaulted OFF, so the stream designators are only shown when 
a change in streams occurs. Turning this command ON will make the stream de- 
signators show on every connected packet received. Turning STREAMCA ON 
will also add the callsign of the “from” station beside the stream designator. 


Round Table Discussions 


Several people talking together present a difficult situation for packet radio since 
the protocol requires two stations to connect in order to make sure they receive 
each others’ packets. If you wanted to be absolutely sure that everyone got every- 
thing you said, you would have to connect to each person and retype everything 
to each person. That could get a bit cumbersome, so most people use the Unproto 
Mode and are aware that a collision may occur once in a while. You can usually 
tell by the conversation if something was missed; if you don’t get an answer to a 
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question it’s probably not that he is ignoring you, but either the question or the 
answer was corrupted by a collision. 


Selective Monitoring 


With MONITOR ON, the BUDLIST command can help in setting up your 
monitoring so you will see only those packets you want to see. You can list up to 
10 calls in BUDLIST. 


Timing 
Dwait vs. Persistence and Slottime 


When the TNC acts as a digipeater, packets received that need to be relayed are 
retransmitted as soon as the frequency is clear. Other TNCs on frequency 
(should) hold off or wait their turn, using a PERSISTENCE/SLOTTIME algo- 
rithm or DWAIT method to determine when to transmit. This practice has been 
adopted to reduce collisions with packets being digipeated, since these packets 
must (by the AX.25 protocol) be acknowledged end-to-end. Kantronics’ current 
TNCs (e.g. KPC-3, KPC-3 Plus, KPC-9612, KPC-9612 Plus, among others), use 
the PERSIST/SLOTTIME algorithm to gain channel access. The default value 
for DWAIT is set to zero. If the DWAIT method is used, the TNC sending 
non-digipeat packets will wait for DWAIT (times 10 milliseconds) time of clear 
channel before beginning to key-up the radio to transmit. 


The algorithm used with the PERSIST and SLOTTIME parameters helps 
avoid collisions by randomizing the wait time before transmitting. The more 
random the timing the less chance of two TNCs transmitting at the same time 
and colliding. 


Once the TNC detects a clear frequency it will wait SLOTTIME (times 10 milli- 
seconds). Then, if the channel is still clear, it will generate a random number. If 
this number is smaller than the setting of PERSIST the TNC will transmit. If it is 
larger it will wait another SLOTTIME and then generate another random number 
and again decide whether to transmit or not. When using PERSIST and 
SLOTTIME you should set DWAIT to 0, since both will be used if specified. 


As an example, let’s assume that PERSIST is set to 63, and SLOTTIME is set to 
10. This value of SLOTTIME results in a random number being generated every 
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100 milliseconds. When the TNC sees that the channel is clear, it waits 100 ms, 
then generates a random number between 0 and 255 (inclusive). If, in our exam- 
ple, the number was 83, then the TNC would not start the key-up of the transmit- 
ter since 83 is greater than the 63 PERSIST value. Instead, it would wait an 
additional 100 ms, and if the channel is still clear, generate a new random num- 
ber. This time, let’s say it comes up with the number 27. Since this is less than 
the PERSIST value, we now start the key-up of the transmitter to send the packet. 


Txdelay 


TXDELAY should be adjusted to allow your radio sufficient time to switch from 
receive mode to transmit mode and develop full power output. If the TNC sends 
the packet before the radio is at full power, the beginning of the packet will be 
lost and no one will be able to decode it. TXDELAY also allows the station you 
are talking to sufficient time to switch from transmit mode back to receive mode. 
The TNC sends flags during the TXDELAY period, so if someone has this set ex- 
tra long you will hear a repetitive sound at the beginning of the packet. 


Frack (Frame Acknowledgment Time) 


If the TNC expects an acknowledgment of a packet it has sent, it will wait 
FRACK seconds for the acknowledgment. If the acknowledgment is not received 
it will either send a poll or retransmit the packet, depending on the setting of 
AX25L2V2. When digis are used, extra time is allowed for each transmission us- 
ing the following equation: 


FRACK * ((2 * n) + 1) seconds 


where n is the number of digipeaters. The lower the baud rate (HBAUD) the 
higher this parameter should be set, because everything is slower. The length of 
the transmission (determined by PACLEN and MAXFRAME) also needs to be 
taken into account when deciding how to set FRACK. Longer packets (and more 
of them) require more time to be transmitted, more time to be repeated by the 
digipeater, and so on down the line. The FRACK timer begins when PTT is re- 
leased (the packet has been sent) and is suspended when data carrier from the ra- 
dio is present, or when your station is transmitting. 


KPC-3 Plus v 8.2 109 User’s Guide 


Modes of Operation Packet Mode of Operation 


Retries AX.25 Level 2, Version 1 vs. Version 2 


The way retries are accomplished depends on AX25L2V2 being OFF or ON. To 
explain this we will follow a conversation through its path. First let’s assume sta- 
tion “A” is connected to station “B” with Version | protocol (AX25L2V2 OFF). 
When station A sends a packet to station B, he expects to receive an acknowledg- 
ment back indicating that station B has received the information. In order to ver- 
ify that the proper packet (or frame) has been acknowledged, each frame has a 
number. This number is sent as a part of the frame so the receiving station knows 
where this packet belongs in the conversation. The frame numbers range from 
0-7 and because of this, we are limited toa MAXFRAME of 7 (we do not want 
the same frame number reused in the same transmission). This is also true for 
Version 2. If the first acknowledgment is received, there is really no difference 
between the two versions, practically speaking. The difference shows up with re- 
tries, so let’s assume that the packet did not get through on the first attempt. 


Let’s assume that station A sends frame number 3 to station B. Station B does not 
receive the frame and therefore no acknowledgment is received by station A. 
With version 1, the entire packet is retransmitted (with the same frame number) 
to station B and this continues until station A receives an acknowledgment from 
station B. This acknowledgment can take two basic forms. The first time station 
B receives frame 3 he will send an acknowledgment of the form “ready to receive 
frame 4” <rr4>. If this acknowledgment is sent, and station A did not receive it, 
station A will again send frame 3. Since station B already received frame 3, he 
would acknowledge it with the form “I’ve already got that frame, send me num- 
ber 4” <rej4>. This is also known as Reject Frame sent. This process would con- 
tinue until the retry count is exceeded when, under version 1, the sending TNC 
will initiate a disconnect and discard the packet. (The monitoring of the com- 
mands shown in <> depends on the settings of MRESP, MCON and MCOM.) 


Now let’s look at the same conditions under version 2 (AX25L2V2 ON). 

Station B does not receive frame number 3 from A and therefore sends no ac- 
knowledgment to station A. This time, station A sends a POLL or question to sta- 
tion B saying, in effect, I’m expecting frame number 0 from you; what frame are 
you expecting from me?" <<RRO>>.Since station B did not receive the frame, 
station B would respond with <<rr3>>, saying “I’m ready to receive frame 3.” 


At this point, station A, upon receiving the rr3 would immediately resend the en- 
tire frame. If station B had already received frame 3 once but the acknowledg- 
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ment never got to station A the question from station A for the retry would be the 
same. Station B’s response however, would be different. He would respond with 
“ready to receive frame 4” <<rr4>>. If station A does not receive station B’s re- 
ply, this “POLL/REPLY” sequence would continue for the number of retries set 
in the sending TNC; if no response was received, and the RELINK 

parameter is ON, the TNC at station A would then begin to issue connect re- 
quests to station B since there is still an outstanding packet of information. This 
is the major difference between version | and version 2. The connect attempts 
would then continue for the number of retries set in the TNC, and if no response 
was received from station B after all of the above, station A would disconnect 
and discard the packet. The parameter RELINK is defaulted OFF to avoid the re- 
connect attempt. 


Flow Control 


The flow control commands insure that the TNC gets everything that is sent to it 
by the computer and that the computer gets everything the TNC sends it. When 
the computer sends the TNC data, the TNC stores this data in a buffer until it can 
packetize it, send it, and get acknowledgments. Similarly, when the TNC sends 
the computer data, the computer stores the data in a buffer until it can be pro- 
cessed, stored to disk, sent to printer, or whatever. 


This buffer area is of limited size; if more data is sent than will fit in the buffer 
the extra data will be lost. To make sure each device gets all the data it should 
from the other device, the two devices can tell each other to start and stop send- 
ing data. This is called Flow Control and it can be accomplished in either of two 
ways, via software or via hardware. 


Which way you implement this depends on the capabilities of your computer 
communications program and personal preference. The cable between your com- 
puter and TNC must also be wired appropriately. 


Software Flow Control 


Software flow control sends special characters on the TXD and RXD lines of the 
RS-232 cable. These are the same lines used for sending regular data between the 
TNC and computer. Software flow control normally sends a <Ctrl+S> to stop 
data and a <Ctrl+Q> to restart data. When a buffer gets close to full, the device 
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will send a <Ctrl+S> and expect the other device to stop. When the buffer gets 
nearly empty, it will send a <Ctrl+Q> to tell the other device to send more data. 
How full or empty a buffer is when the special characters are sent is determined 
by the program. But, since the regular data lines are being used, a <Ctrl+S> sent 
as data from the keyboard will also stop data from the TNC. And likewise, if 
there is a <Ctrl+S> in a file being sent, data flow from the TNC will stop until a 
<Ctrl+Q> is received. 


XFLOW needs to be turned ON for the TNC to use software flow control. XOFF 
determines the character sent by the TNC to stop the flow of data from the com- 
puter, and the XON character restarts the flow. The TNC expects the computer to 
send the STOP character to stop data to the computer and the START character to 
restart data. To use software flow control these commands would be set as fol- 
lows: XFLOW ON, XOFF $13, XON $11, STOP $13, START $11. (Default set- 
tings.) 


Two commands are provided to make it possible to send and/or receive these spe- 
cial characters in Transparent Mode and still use software flow control. 
TXFLOW enables flow control sent by the TNC to the computer and TRFLOW 
enables the TNC to recognize flow control sent by the computer. If both these 
commands are ON (and the above commands are set as stated) then software 
flow control will take place in both directions, to and from the TNC and com- 
puter. 


+ Ifyou are in Transparent Mode sending a file, the computer does not need to tell 
the TNC to stop and start (since you are sending the file). By turning TRFLOW 
OFF and TXFLOW ON, the TNC will accept START and STOP characters em- 
bedded in the file and send them along to the radio as data. Meanwhile, the TNC 
can send the XOFF and XON characters to the computer to control the flow of 
data from the computer. When receiving a file, tum TRFLOW ON and TXFLOW 
OFF; the computer will accept all data and use START and STOP characters to 
control the flow of data from the TNC. 


Hardware Flow Control 


Hardware flow control monitors the voltages on the RTS and CTS pins of the 
RS-232 cable. Therefore these two pins must be wired between your TNC and a 
connected computer. The TNC holds CTS high as long as it can receive data. 
Once its buffer gets full, it pulls this line low. The computer program monitors 


User’s Guide 112 KPC-3 Plus v 8.2 


Packet Mode of Operation Modes of Operation 


this line. When it is pulled low, it knows to stop sending data. When the line is 
again pulled high by the TNC, the computer program will restart sending data. 
On the other hand the computer holds RTS high as long as it can receive data and 
pulls it low to tell the TNC to stop sending data. The TNC always uses hardware 
flow control, so only wire the RTS and CTS pins if your computer program is 
also using hardware flow control. 


+  Pacterm uses hardware flow control, but some communication software does 
not. 


Convers Mode vs. Transparent Mode 


In the Convers Mode there are many special characters. To list a few: 


Command Default Description 

SENDPAC <Ctrl+M> Causes a packet to be formed 

DELETE <Ctrl+H> Backspace character 

REDISPLAY <Ctrl+R> Redisplays the keyboard 
buffer 

CANLINE <Ctrl+X> Cancels a line 

STOP <Ctrl+S> Stops output from TNC to com- 
puter 

PASS <Ctrl+V> Pass a special character 


These characters are all very useful when having a packet conversation with 
someone. If you want to send a packet you hit the return. If you make a mistake 
you can erase characters, using the delete or backspace key, or kill the whole line 
with <Ctrl+X>. And if you really want to transmit one of these characters, you 
can always precede it with a PASS character. 


Transparent Mode was designed for the sending of files, whether they be ASCII 
data files or program files. Special characters have no meaning to the TNC in 
transparent mode, they are just characters to be put in a packet and sent to the 
radio. 


In Transparent Mode, a SENDPAC character will not cause data to be formed 
into packets; instead, packets are formed at a rate that is set by PACTIME. 


All monitor commands are treated as OFF in Transparent Mode. All you will see 
is what is being sent to you. You would probably want to set USERS to 1 so no 
one interferes with the transfer. The setting of ECHO is also ignored. Even if 
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ECHO is ON Transparent Mode will not echo to the attached terminal. Some 
programs allow for local echoing to the screen while uploading. 


Getting Out of Transparent 


Getting into the Transparent Mode is easy: you just type a “t” in Command 
Mode. But since Transparent Mode allows the sending of all characters you can 
not get out of Transparent Mode by just typing a <Ctrl+C> (COMMAND charac- 
ter) as in Convers Mode. In order to get out of Transparent Mode, you must fol- 
low a special sequence, or use a modem break if your program supports one. The 
special sequence must be followed precisely. This example assumes the COM- 
MAND character is <Ctrl+C> and CMDTIME is | second: 


e Wait at least 1 second since the last character was sent from the computer 
to the TNC 


e Type a <Ctrl+C> 

e Within | second type a second <Ctrl+C> 

e Within | second type a third <Ctrl+C> 

e Wait 1 second and the cmd: prompt should appear 


If the guard time of one second before and after the three <Ctrl+C>s is not there, 
the TNC assumes that they are data and sends them to the radio, so be sure to al- 
low at least one second before and after the three <Ctrl+C>s. 


Remote Access to Your TNC 


Your can connect to your TNC from a remote station and change values of your 
TNC’s parameters. This allows you to add or delete stations from the LLIST, 
change the size of the PBBS, change the MYCALL and so on, all remotely. Ex- 
treme caution must be used when you are accessing your TNC from a remote lo- 
cation. There is no built-in safeguard, and as such it is possible for you to change 
parameters such that the remote TNC will no longer communicate with you. 
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In order to change parameters in a remote TNC, the RTEXT in the remote TNC 
must be set to a text string that will be used as the password string. For instance, 
you might set your RTEXT to: 


RTEXT Code 


The remote TNC must also have its MYREMOTE set to a unique callsign (i.e. 
W@ABC-4, or XYZREM). If these two parameters are not set, remote access to 
the command set of this TNC is not possible. When these parameters are set, you 
can connect to the MYREMOTE callsign of the remote TNC. 


When the connection is made, the remote TNC will send three lines of numbers. 
The numbers may look like: 


1113 4 3 
3.1. 453° 3 
2d Gee eS 


You must then pick ONE of these lines and decode the password string. Let’s say 
you choose to decode line 3 (2 1 1 2 1 3). Rewriting your RTEXT string to make 
this easier you would have: 


Character #: 1 2 3 4 
Letter: Gr %@y «d>.e 


Therefore, to gain remote access, you must send the following string: 


oCCoCd 


Note that case is significant and spaces are considered valid characters. 


If you fail to properly decode the password, the TNC will send three new lines of 
numbers. You will be given a maximum of three attempts to properly decode the 
password string. If you fail in three attempts, the TNC will disconnect you and 
disable connects to the MYREMOTE for 15 minutes. Also, if you connect to the 
MYREMOTE and start the password sequence but then disconnect, the penalty 
timer is in effect for 15 minutes. 


Be careful when using the remote access feature. You can change ANY command 
in the TNC without restriction, but this can lead to problems. For instance, if you 
change the INTFACE command to KISS and then send a RESET command, the 
remote TNC will be placed into the KISS mode and will completely quit talking 
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to the radio! Also, if you connect to the MYREMOTE of a TNC and then issue a 
command like CONNECT W1ABC, the remote TNC will indeed connect to the 
station, but there will be no data sent to you from that connection. The connected 
data would be sent to the serial port of that remote TNC. We urge EXTREME 
caution when using the remote access! Note also that any command that causes a 
reset (i.e. NUMNODES, PBBS, MAXUSERS) will disconnect all current users 
(PBBS, NODE, and YOU). 


One other minor limitation applies to receiving data from the remote TNC. When 
you give any command, the response is limited to 300 characters so some com- 
mands will not fully display their response. If you give the command DISPLAY, 
the full list will begin, but you will not receive the entire list because of the limi- 
tation on this buffer. 
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PBBS (Personal Mailbox) 


Introduction 


Your TNC includes a Personal Bulletin Board System (PBBS), a mailbox, which 
is capable of storing and forwarding messages for you and other users. This 
PBBS provides the same message facilities as a computer based packet radio 
BBS, normally referred to as a full-service BBS, including the forwarding of 
Bulletins, Private mail, and NTS traffic (for more information on the national 
network of full-service PC-based packet BBS systems, see a current ARRL oper- 
ations manual). 


+ Historical note: The first BBSs in packet radio were PC-based, using software 
developed by Hank Oredson, WORLI. A national system of packet-radio based 
BBSs has developed, permitting the automatic forwarding of messages, and files, 
from one BBS to another. Today, the large capacity packet radio BBSs are still 
PC-based, but TNC-based BBSs now provide similar facilities, with medium ca- 
pacities. 


The personal mailbox is compatible with the large community bulletin board sys- 
tems (RLI, MBL, etc) and will allow them to forward mail for you directly into 
your TNC. You may also place messages in your mailbox, and if the local Com- 
munity BBS system allows, your TNC mailbox will reverse forward these mes- 
sages from your personal mailbox into the community system on request. You 
can even set up your TNC mailbox to automatically connect to the community 
BBS and forward any messages it has. 


Using Your PBBS 


In order to use any Kantronics TNC PBBS (even your own), first get the cmd: 
prompt on your TNC, and then connect to the callsign of the PBBS. For instance, 
if your MYPBBS is NOKN-1, you would connect to it simply by typing 

“C NOKN-1". In this example, the PBBS is in your own TNC, so no packets 
would be transmitted, but you would connect to the PBBS and receive the same 
prompt as if you had connected to someone else’s PBBS. 


When you connect, you will first see the message from your TNC indicating that 
you are connected: 


*** CONNECTED to N@®KN-1 
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The PBBS will then send you its SID (Status ID - e.g., equipment ID) and initial 
sign-on message. If a PTEXT is defined, the TNC will send it as the next line, 
and then send the PBBS command prompt. For example, a Kantronics 

KPC-3 Plus might respond to your PBBS connect with the following: 


[KPC3P-7.0-HMS ] 

4528 BYTES AVAILABLE 
PTEXT would be here (if any) 

ENTER COMMAND: B,J,K,L,R,S, or Help > 


+ Using anyone else’s Kantronics-based PBBS would result in a similar prompt se- 
quence. 


At this point you are ready to send a message to another user, read a message to 
yourself (if any has been received), or issue any other mailbox command. 


Let’s assume you want to send a message to KBONYK. You would now use the 
Send Private command: 


SP KBONYK 
and the TNC responds with: 
SUBJECT: 


Now enter a short subject line: 
Just a quick question 
The TNC responds with: 


ENTER MESSAGE n-END WITH CTRL-Z OR /EX ON A SINGLE LINE 


(where “n” is the next available message number in the mailbox). 


Now you enter the text of your message (message n). To end the message and 
have it saved, type a <Ctrl+Z> (hold down the control key and press Z) or type 
/EX. The <Ctrl+Z> or /EX must be on a line by itself — do not type anything 
else on this line. When the message has been ended properly, the PBBS responds 
with: 


MESSAGE SAVED 
ENTER COMMAND: B,J,K,L,R,S, or Help > 


You may now enter more mailbox commands. 
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+ The “Mail” indicator on the front panel of your TNC blinks to alert you to 
unread mail addressed to you (i.e., to the callsigns of MYCALL or MYPBBS). 
See the TNC command PBLIST for how you can add other callsigns to the list of 
callsigns that are to be included as “mine.” The PBLIST is also used with the 
PBPERSON command and the following PBBS commands: LMINE, KMINE, 
and RMINE. Note that the mail-status indicator on the front panel of the TNC is 
turned ON (without blinking) when someone is connected to your PBBS. 


PBBS Commands 


The commands available to users connecting to your Kantronics TNC PBBS (and 
you connecting directly) are as follows: 


B(ye) 
This command is entered by the PBBS user to disconnect from the PBBS. 


E(dit) n [BPTYNFH] [>tocall] [<fromcall] [@BBS] “old” 


This command is available only to the system operator (SYSOP) or to a user at 
the keyboard of a computer connected directly to the TNC (i.e., not to a remote 
connection, except for the SYSOP). For an explanation of this command, see the 
section below on “Editing Message Headers.” 


H(elp) 
Displays a HELP menu. 


J(heard) 


Displays a list of stations recently heard by the TNC. The list will include a date 
and time stamp indicating when each station was heard. 


J(heard) S(hort) 


This command is similar to the J(heard) command above, but only displays the 
callsigns of the stations heard. 
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J(heard) L(ong) 


This command is similar to the J(heard) command above, but also displays any 
digipeaters used by the stations it has heard and the destination callsign. 


L(ist) [x[yl] [1 


Lists all messages in the mailbox which you are allowed to read. This will in- 
clude all BULLETINS, TRAFFIC, and any PRIVATE messages addressed TO 
you or sent by you. If you are the SYSOP (keyboard or remote) ALL messages 
will be listed. 


You have the option of specifying a beginning message (x = START #) and, if 
you do so, an ending message for the list (y = END #). Also, specifying the op- 
tional semi-colon (;) in any List command will also show the @BBS and BID 
(BULLETIN ID - see section on “Sending Messages”) of the messages (if any). 


L(ist) <|> call [;] 


Allows you to list only those messages in the mailbox which are addressed to a 
specific callsign (>), or which were sent by a specific callsign (<). To list only 
those messages addressed to AMSAT for instance, you would give the command 
L >AMSAT. 


LB [3] 


Lists all BULLETINS in the mailbox. 


LC [cat[;]] 


Using the LC command by itself will cause the PBBS to list the TO field of all 

BULLETINS in the mailbox. This will just be a list of the actual TO fields, and 
not a list of the messages. If you specify a category (i.e. LC RACES) the PBBS 
will list the full message headers of all BULLETINS addressed to that category. 


LLn [3] 


Lists the most recent n number of messages in the mailbox. Again, only BULLE- 
TINS, TRAFFIC, and PRIVATE which you are allowed to read will be listed. 
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LM(ine) [;] 


Lists all messages in the mailbox which are addressed to you. 


LO [+]-] 


This command allows you to change the order in which messages are listed. 
When set to +, the messages are listed in ascending numerical order (oldest to 
newest). When this command is set to “-”, the messages will be listed starting 
with the highest message number (newest to oldest). This command will not be 
available if the SYSOP has the PBLO command in his TNC set to FIXED. 


LT [3] 
Causes the PBBS to list all TRAFFIC messages that are currently in the PBBS. 


K(ill) n 


Deletes message number n from the mailbox. You may only delete TRAFFIC 
messages, PRIVATE messages addressed TO or FROM you, or BULLETINS 
you sent. The SYSOP may delete any message, including BULLETINS. 


KM(ine) 


Deletes any messages in the PBBS addressed to you that you have read. If you 
have not read a message addressed to you, it will not be deleted. 


R(ead) n 


Reads a specific message by number. Only PRIVATE messages addressed TO 
you, or sent by you, may be read, as well as any BULLETIN or TRAFFIC mes- 
sages. After you read a PRIVATE message addressed to you, the STATUS flag 
will automatically be set to Y — it has been read. 
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RH n 


The RH (Read with headers) command is a variation of the Read command. 
Using RH instead of R gives you message headers as well as the other informa- 
tion provided by the Read command. The message header contains the date/time 
the message was received at each forwarding BBS along the path to your station. 


RM(ine) 


Displays all messages in the PBBS addressed to you that you have not already 
read. 


S(end) call 


Sends a PRIVATE message to the callsign specified. Using S(end) is the same as 
using the SP command. 


SB cat 
The SB (Send Bulletin) command is used to send a BULLETIN to the PBBS. 


SP call 


The SP (Send Private) command is used to send a PRIVATE message to a speci- 
fied callsign. Using this command is the same as using the S(end) command. 


ST zip 


The ST (Send Traffic) command is used to send NTS type traffic messages to the 
PBBS. 


Some of these commands are described in more detail below. 
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Sending Messages 


The SEND command (and its many forms) allows the following syntax: 


S call [@ bbcall[.haddr] ] [S mid] 
SP call [@ bbcall[.haddr] ] [S mid] 
ST zip [@ location[.haddr] ] 

SB cat [@ location[.haddr] ] [S$ bid] 


where: 
e call is the callsign of the station the message is addressed to. 
e = bbeall is the callsign of a full service BBSto deliver the message to. 


e haddr is the complete Hierarchical address designator for the BBS 
system or destination of the message (see the section below on 
“Hierarchical Addresses” for more detailed information). Contact your 
local community BBS SYSOP for complete information on local 
Hierarchical addressing. 


e location is the designator used for distribution of the message. For 
TRAFFIC, this should be NTSxx where xx is the two letter POSTAL 
code for the state. 


e mid is the MESSAGE ID assigned to the message by the originator. 
e bid is the BULLETIN ID assigned to the message by the originator. 
e zip is the 5 digit postal zip code (or postal code) 


e cat is the message category. For instance, a message requesting help on a 
subject may be sent to the category HELP, info sent to INFO, items for 
sale to SALE, etc. Contact your local community BBS SYSOP for some 
other examples and suggestions. 


Some examples of commands would be: 


SP WB5SBBW @ W5AC.#STX.TX.USA.NOAM 


This command sends a private message to WBS5BBW. The message should be 
sent to the W5AC BBS system, in South Texas (.4STX), which is in Texas (.TX), 
which is in the USA (.USA), which is in North America (NOAM) where 
WBS5BBW can retrieve it. 
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ST 88030 @ NTSNM 


This command sends an NTS traffic message to a non-ham, or to someone who is 
not on packet, living in zip code 88030 which is in New Mexico. The location 
field contains the NTSxx (xx = NM) to indicate that the 88030 zip code is in 
New Mexico. 


SB RACES @ ALLUS SRACESBUL.010 


This command sends a bulletin addressed to RACES, which should be sent to all 
BBS system in the USA (ALLUS) and has been assigned the Bulletin ID (BID) 
RACESBUL.010. This BID prevents the same message from being duplicated as 
it travels throughout the BBS system. 


When you send a message to the PBBS, you must include the @BBS 
(bbcall[.haddr]) field if you want the message to be reverse forwarded from the 
PBBS to a full-service BBS system. Any message entered into the PBBS over the 
radio will initially be marked with a status of H (held) and will not be reverse for- 
warded until the SYSOP has edited the message header and changed the H flag. 
This gives the SYSOP full control over the messages relayed by his station. 


Messages entered from the local keyboard connected to the TNC do not require 
editing in order to be reverse forwarded, but must include at least an @BBS field 
to enable the reverse forwarding. 


Listing Messages 


When you list messages with any of the LIST commands, you will get a display 
similar to the one shown below. If you specify the optional semi-colon (;) you 
will also see the @BBS field (if it exists) in square braces after each line. 


MSG# ST SIZE TO FROM DATE SUBJECT 

6 B 45 KEPS W3IWI 12/19/91 09:37:11 2 Line Element 
set 

4 B 26 HELP WBSBBW 12/19/91 09:34:05 Xerox 820 

3 T 38 66044 W@OUU 12/19/91 09:33:42 QTC Lawrence 
913/842 

2 PN 14 N@APT WSC 12/19/7912. 09233227 AMTOR 

1 B 30 ALL NOKN 12/19/91 09:32:49 Need help on 
AMTOR 


9712 BYTES AVAILABLE 
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NEXT MESSAGE NUMBER 7 
ENTER COMMAND: B,J,K,L,R,S, or Help 


The message number (MSG#) is listed, followed by the STATUS of the message. 
This status includes the message type (B=Bulletin, T=NTS traffic, and 
P=Personal message). The second character in the ST column is the current status 
of the message. 


A Bulletin status (type B) can be: 
F — it has already been forwarded to another full-service BBS 


H — it is being held for review by the SYSOP because it was entered into the 
PBBS over the radio. 


An NTS traffic message (type T) may have a status of: 


H — indicating that it is being held for review by the SYSOP before it may 
be forwarded. 


The Private message (type P) can have the following status characters in the sec- 
ond position: 
H — This is a personal message that has an @BBS field but is being held for 
review by the SYSOP before it may be forwarded. 
N — This message is a Personal message that has not been forwarded and 


has not been read by the station it is addressed to. If it is forwarded to a 
full-service BBS, it will be deleted if PBKILLFW is ON. 


Y — This message has been read by the station it is addressed to, but has not 
been killed. It will not be forwarded even if it has an @BBS since it has al- 
ready been read. 


Reading Messages 


To read a message (e.g., a bulletin such as that in the previous section listed as 
being to ALL), use the READ command (see PBBS comand section for details 
on using this command). 
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Editing Message Headers 


The following command can be used to edit message headers: 


E(dit) n [BPTYNFH] [>tocall] [<fromcall] [@BBS] “old” 


This command, available only to the system operator (SYSOP), or to a user at the 
keyboard, allows the sysop to edit the message headers listed below for any mes- 
sage in the mailbox. You are the sysop if you can connect to the PBBS from the 
RS-232 port. You can also gain sysop status by connecting to the PBBS remotely 
(by radio); see the section titled “Remote Sysop Access to your PBBS” for more 


detail. 

The TYPE of the message: 
B — Bulletin 
P — Private 
tT — Traftic 


The STATUS of the message: 


Y — Yes [it has been read] 

N — No [it has not been read] 

F — Forwarded [it has been forwarded] 

H — Held [it is not available for reverse forwarding] 


Note: F and H are toggles. Entering F switches the status of the message from F to 
NOT F or from NOT F to F. Similarly, entering H switches the status of the message 
from H to NOT H or from NOT H to H. 


Who the message is to or from: 


>tocall 
<fromcall 


The destination mailbox (@BBS): 
@BBS[.haddr] 


And the subject or text of the message: 
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In the message, replace the FIRST occurrence of the 


string 
“old” with the string “new”. 


When a message is listed, the “tocall” and “fromcall” appear in the TO and 
FROM columns, respectively. If a message has been entered with an “@BBS” 
for forwarding, the complete hierarchical address is shown when the message is 
read: 


MSG2 02/10/92 10:30:58 FROM KB@NYK TO HELP 
@wa4ewv.#stx.tx.usa.noam 


The @BBS is also listed when using the semi-colon (;) option with any of the list 
commands. 


You can access the Edit command by connecting to the mailbox from the at- 
tached terminal, or by connecting over the radio. If you connect over the radio, 
you must gain SYSOP privilege by giving the SYSOP command. When you give 
the SYSOP command, the PBBS will send you a password verification string 
which must be properly responded to in order to gain SYSOP access. This is ex- 
plained in detail later. 


Let’s say you want to edit message number 2 which currently is a PRIVATE mes- 
sage addressed to WOXI. The message has been read by WOXI so it shows a sta- 
tus of Y. It may list as: 


MSG# ST SIZE TO FROM DATE SUBJECT 
2 PY 53 WOXI N@KN 01/14/92 03:36:45 Good 
afternoon 


Let’s say you 


want to change this so that it is addressed to NOGRG and also change the Y flag 
to N to show that it hasn’t been read. To do this, you connect to your PBBS (ei- 
ther from the KEYBOARD or as SYSOP over the radio), and issue the com- 
mand: 


e 2 N >NO@GRG 


You could do this with two separate commands, or it may be accomplished with 
the single command shown above. 
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Hierarchical Addresses 


Hierarchical addresses (explained below) are used to accommodate the national 
packet traffic system, including messages processed by PC-based packet radio 
BBSs. 


The HTEXT command allows you to set your Hierarchical address. This is used 
whenever your PBBS forwards mail to another BBS to provide complete return 
addressing capability. Other PBBS features include the ability to select whether 
or not to kill private and traffic messages after they have been forwarded, and 
whether or not to HOLD messages received over the radio. 


A hierarchical address consists of your state, country, and continent codes, sepa- 
rated by periods. Some areas (in large states particularly) use sub-state designa- 
tors. For instance, a station in Rhode Island might use a hierarchical address of 
RILUSA.NOAM. This means Rhode Island (RI) which is in the United States 
(USA) which is in North America (NOAM). In this case, you should set the 
HTEXT to RI.USA.NOAM. If you are unsure of your hierarchical address, con- 
tact your local packet BBS sysop and ask what the proper addressing is for your 
location. 


The PHEARD command will show you the callsigns of stations recently connect- 
ing to your mailbox along with their start and stop times. 


Advanced Configuration of Your PBBS 


When you first enter your callsign into the TNC, your PBBS will automatically 
be enabled. The MYPBBS callsign is set to your basic call with an SSID of -1, 
and the PBBS 1s allocated either 5K or 100K of RAM, depending on whether you 
have 32 or 128 K of RAM installed. 


You may change the size of the PBBS using the PBBS command. The maximum 
amount of memory you can allocate will depend on the amount of free memory 
available. NUMNODES, MAXUSERS, and MYREMOTE, etc.,will affect the 
amount of available memory. 


If you change the size of the mailbox, the TNC will not renumber any existing 
messages, and if the new size is large enough for all existing messages, no mes- 
sages will be lost. If you want to renumber the messages (starting with 1) give the 
PBBS n command with n being the current size (i.e., nK of memory 

assigned to the PBBS). 
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+ To see the current size of the mailbox, enter the command “PBBS” (without any 
number) at the Command prompt. 


At times, you may be away from your computer and would like to switch a user 
into your mailbox automatically if he connects to your MYCALL. This can be 
accomplished by setting the CMSG command to PBBS. When this is done, a user 
who connects to your MYCALL will be sent your CTEXT (if any) and then be 
automatically connected to the PBBS. The TNC will then send the PBBS System 
ID (SID) and sign on message. The SID is enclosed in square brackets and con- 
sists of the unit name, firmware version, and the supported feature set. 


For example the Kantronics KPC-3 Plus SID is: 
[KPC3P-7.0-HMS] 


This is the unit name (KPC3P), version number (7.0) and the feature set (HM$). 
The H means it supports Hierarchical forwarding, the M stands for Message ID, 
and the $ indicates BID support. These identifiers are the SID definitions 
published by Hank Oredson (W@RLI) with his Community BBS system. 


You can customize a greeting message to be sent to a user who connects to your 
PBBS by using the PTEXT command. This command accepts up to 128 charac- 
ters as a text string to be sent to the user immediately after the SID is sent. 


If it becomes necessary to disconnect a station from your PBBS, you can use the 
local terminal connected to your TNC to accomplish this (see DISCONNECT 
MYPBBS). If a station connects to your PBBS and no activity occurs on the con- 
nection for 15 minutes, the PBBS will automatically disconnect the user in order 
to make your PBBS available to others. 


Note: To get forwarding or reverse forwarding, you need to have HTEXT set. 
HTEXT specifies your Hierarchical address, which is needed for complete return 


addressing capability. 


If a community bulletin board forwards messages into your PBBS, it sends you 
many lines beginning with “R:”. These are routing headers that show the com- 
plete path taken by this message. By default, these headers will be stored in your 
PBBS with the message. If you choose, you may prevent your PBBS from stor- 
ing these by setting the PBHEADER command OFF (for more information, see 
the section below titled “Routing Lines”). 
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If you want your PBBS to only accept messages for you, you can set the 
PBPERSON command ON. When set ON, this command will make your PBBS 
only accept messages that are addressed to your MYCALL, MYPBBS or 
PBLIST. 


Finally, the PBLO command is used to determine the order in which messages 
are listed to a user. When set to OLD, messages will be sent oldest first (message 
1, then 2, etc). When set to NEW, the most recent message will be listed first. 
The second parameter of this command determines whether or not you will allow 
a PBBS user to change the listing order while he is connected. When set to 
FIXED, the user cannot change the order, and when set to VARIABLE, the user 
may change the order by connecting to the PBBS and using the LO command. 


Remote SYSOP Access to the PBBS 


You can gain remote SYSOP access to your PBBS (e.g., to edit messages, using 
the EDIT command) by first connecting to your PBBS and then entering the 
SYSOP command. When you enter the SYSOP command, you will receive three 
sets of numbers from the PBBS. These numbers indicate the character positions 
of the RTEXT to be used as the password for logging on for this remote access. 


For instance, let’s say your RTEXT is: 
This is a sample rtext. 
Now when you give the SYSOP command, the TNC might respond with: 


ik 12 3 18 6 9 
2 10 22 5. 7. 18 
13 16 4 9 1 20 


If you choose the first set of numbers, you should send the following as a re- 
sponse: 


Tairia 
(T is the 1st letter, a is the 12th letter, i is the 3rd letter, and so on. See the 
RTEXT command in the Commands section for a more detailed explanation.) 


NOTE: Spaces DO count as characters, and case is significant! 
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Reverse Forwarding Messages from Your Mailbox 


The TNC mailbox will allow you to enter messages which will be forwarded by 
full-service BBSs (RLI, MBL, etc). These messages have a special format, and 
can be entered in any personal mailbox. Let’s suppose you want to send a mes- 
sage to WA4EWV who lives in Texas. You know his home BBS is WB5BBW, so 
you can put this message in the PBBS with the command: 


S WA4EWV @ WBSOBBW 


Entering an @ BBS will cause the TNC to reverse forward this message to a full 
service BBS when requested by the full service BBS. In order to improve the 
chances of this message reaching its destination, you should always enter the 
message with complete hierarchical forwarding: 


S WA4EWV @ WBSBBW.#STX.TX.USA.NOAM 


Complete information on Hierarchical forwarding can be obtained from your lo- 
cal BBS system operator, but basically the first field after the @ symbol is the 
HOME BBS of the station you are trying to send a message. The next several 
fields (separated by periods) are the state (two letter postal abbreviation), coun- 
try, and continent. In this case, since Texas is so large, it is sub-divided into 
smaller areas. These are indicated with the # symbol (in this case #STX — South 
Texas). 


Messages entered into your mailbox in this format will be reverse forwarded to 
the full service BBS when requested, and the following rules apply: 


The TNC acts like a “smart BBS” when forwarding to or from a full service 
BBS. This means that it will no longer send the SUBJECT: prompt, nor will it 
send the ENTER MESSAGE prompt. You will also notice that when a 
full-service BBS connects to your PBBS, the TNC does not send the usual 
ENTER COMMAND prompt, but only the > is sent. This is designed to reduce 
the amount of data on the packet network, since “smart” BBSs know what is ex- 
pected of them. 


Once a Private or Traffic message has been successfully forwarded out of your 
mailbox, it will be deleted from the PBBS if PBKILLFW is ON. Bulletins will be 
marked with a status of “F” and will remain in the PBBS. 
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Selecting a Home Full-Service BBS. 


One important use of your Kantronics PBBS is to connect to the national system 
of packet-radio based BBSs, which was described earlier in the “historical note” 
at the beginning of the PBBS section. You can use a “home” full service BBS for 
sending and receiving mail, much as you would use a P.O. Box at a postal facil- 
ity. The full-service BBS should always be on and available to handle mail for 
you. 


Each PBBS user should select one (and only one) PC-based, full-service BBS for 
sending and receiving mail. This BBS is then called your HOME BBS and 
should not be changed unless you move to a new location. When you connect to 
your home bulletin board system and list the messages (using the L command), 
you will see a list containing information about each message on the system. A 
list of messages on one local full-service system might look like this: 


Msg # TSL Size To From @ BBS Date/Time Subject 
Sesss= === S555 S255= S=555= ==555=5= =25=/ss== ======= 
59765 BS 1491 NASA N5SIST ALLUS 1004/1529 GALILEO STATUS 09/30/93 
59764 BNL 468 WX NONEJ 1012/1017 KC Forecast 10/12 400am 
59763 BNL 659 WX NONEJ 1012/1017 MO Forecast 10/12 400am 


59759 BS 2240 NASA NSIST ALLUS 1004/1529 MARS OBS. STATUS 9/27/93 
59758 BS 1642 NASA N5SIST ALLUS 1004/1529 MARS OBS. STATUS 9/22/93 


This list shows the message number, type and status information, the size of the 
message, the addressee (TO field), the originator (FROM field), and the @BBS 
field. In addition the list shows the date and time the message was received at 
this BBS and a short subject for the message. 


Routing Lines 


Under current FCC requirements, BBS systems that can store and forward mes- 
sages without an operator being present must have the capability to provide a re- 
cord of the path the message has taken from its origination. To accomplish this, 
BBSs include a routing line, beginning with “R:”. This “R:” line includes the 
date and time the message was received, message number, BBS call and hierar- 
chical routing information. 


When you read a message using the R command (e.g. R 59765) you see the 
header displayed. For example: 


User’s Guide 132 KPC-3 Plus v 8.2 


PBBS (Personal Mailbox) Modes of Operation 


From : NSIST 

To : NASA @ALLUS 

Type/status : BS 

Date/time : 04-Oct 15:29 

Bid : NASA0930.GAL 

Message # : 59765 

Title : GALILEO STATUS 09/30/93 

Path : !N@KN!NOLLY!NOOER! NOOBM!NXOR!AGON 


!N7MMC!KTOH!KAOWIN!NSIST! 


The Path: statement in the header lists the most recent BBS systems that have 
been used to relay this message from its origin to the BBS you read it from. This 
path information is required by the FCC to allow them complete traceability for 
any message in the system. What you see in the PATH statement is not the com- 
plete information on the routing, but simply a summary of the systems that have 
handled the message. To see the complete information, BBS systems allow a sec- 
ond version of the READ command (RH or V) that will display more routing in- 
formation. A routing list from a bulletin appears below. 


R:931012/1107 27268@NOKN.#NEKS.KS.USA.NOAM 
R:931012/1025 16433@NOLLY.#NEKS.KS.USA.NOAM 
2931011/2021 928@NOOER.#NEKS.KS.USA.NOAM 
:931008/1814 20728@NOOBM. #NCKS.KS.USA.NOAM 
:931008/2003 19520@NXOR. #NKS.KS.USA.NOAM 
2931008/1153 30798@AGON. #WNE.NE.USA.NOAM 
:931007/1147 35850@N7MMC. #SEWY .WY.USA.NOAM 
2:931007/1712 49403@KTOH. #NECO.CO.USA.NOAM 
2:931007/1639 63792@KAOWIN.#SECO.CO.USA.NOAM 
2931004/1529 46383@N5IST.#WTX.TX.USA.NOAM 


ABD DDAD 


ve) 


By examining this list from the bottom up, we may see that the message entered 
the system on October 4, 1993 at 15:29 (R:931004/1529). It was message number 
46383 on the NS5IST BBS (@NSIST) which is located in West Texas (HWTX), 
which is in Texas (TX), which is in the United States (USA) which is in North 
America (NOAM). From this station, it was relayed on October 7 at 16:39 to the 
KAOWIN BBS in Southeastern Colorado. By following this information it is pos- 
sible to determine where the message traveled and when it was relayed from each 
station. The information following the @BBS callsign is called the hierarchical 
routing information (in this case #WTX.TX.USA.NOAM). 


KPC-3 Plus v 8.2 133 User’s Guide 


Modes of Operation PBBS (Personal Mailbox) 


When you connect to your local BBS and send a message, that BBS automati- 
cally generates this R: line. As the message is sent to its destination, each BBS 
adds its own R: line to the message. Besides the requirement of the FCC, the R: 
line provides a method for any user, anywhere in the world, to send a reply or re- 
spond to your message. As the message is passed through the many BBSs, each 
BBS will add you into its White Pages — a directory of packet users. Each BBS 
makes note that you (the originator of the message) sent the message, and that 
you entered the message at the BBS listed in the last R: line in the message. 


Because of this, a distant user can simply send a reply using the send reply (SR) 
command of his local BBS. That BBS will then address the message to you using 
the @BBS and hierarchical routing information in the last R: line of the message 
you sent. A user may also simply use the send private command (SP) to send a 
message to you. If the user does not enter complete addressing on his SP com- 
mand, the BBS will attempt to look up your call in its White Pages and add the 
routing automatically. However, if the user supplied complete addressing infor- 
mation, the BBS would normally assume it is correct and not check the White 
Pages. 


BBSs use this hierarchical information to send the message back to you. The 
message someone sent to you (using the above example) would be addressed to 
URCALL @ NSIST.#WTX.TX.USA.NOAM. As the message passes through the 
BBS system for forwarding, the BBS first looks at the callsign of the addressee 
(URCALL). If that BBS doesn’t know how to forward the message to you, it then 
looks at the @BBS field (NSIST). If it doesn’t have any information on how to 
forward to NSIST, it looks at the first part of the hierarchical address (HWTX), 
not knowing that, it would then look at the next part of the hierarchical address 
(TX). Assuming this BBS is in the United States, it knows TX means Texas and 
knows that this message needs to be relayed to a station in that area. 


Once the message reaches the first BBS in Texas, that system must use the previ- 
ous field for forwarding (#{WTX). Once it reaches a system in West Texas, the 
forwarding occurs based on the @BBS. 


When the message reaches the BBS specified in the @BBS field, it can forward 
the message directly to you, since you are using that system as your HOME BBS. 


When you enter a message into your Kantronics PBBS and supply the routing in- 
formation, that message may be forwarded automatically to another BBS. When 
the message is forwarded from your Kantronics mailbox, an R: line is included as 
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the originating BBS. This line includes the same information as any other BBS. 
This R: line consists of the date/time the message was entered into your PBBS, 

the message number, your MYCALL (URCALL) and the HTEXT you have set. 
For instance, your R: line might be: 


R:931008/1255 23@URCALL. #WTX.TX.USA.NOAM 


Some BBS operator groups are insisting that your system is NOT a BBS, and 
therefore should not include R: lines. Their reasoning is that in the above exam- 
ple, EVERY BBS in West Texas would have to know how to send messages to 
your callsign not just to your HOME BBS. One solution to this is to include the 
callsign of your HOME BBS as part of your HTEXT. This would change your R: 
line to: 


R:931008/1255 23@URCALL.N5IST.#WTX.TX.USA.NOAM 


As this forwards through the system, all West Texas BBSs can still forward the 
message to NSIST because his call is a part of the hierarchical routing. 


As of this writing, there seem to be at least two groups with strong opinions on 
the use of, or prohibition of, R: lines by TNC based PBBSs. Some think the vol- 
unteer BBS network may be overloaded by personal boards including the R: 
lines; others insist that the R: lines are required by regulations. We suggest you 
adapt to local custom by turning the R: line feature ON or OFF accordingly. 


If your local SYSOP demands that you not add R: lines to your messages, you 
must set the PBPERSON command ON. This will limit your PBBS to receiving 
messages addressed ONLY to your MYCALL or your MYPBBS call. In addition, 
your PBBS will only forward messages from YOU (no third-party messages) and 
will not add the R: line to the routing. 


Hint: When you read messages with the normal READ command, the TNC will not 
display those R: lines, but instead will display a short PATH: line, indicating the 
most recent BBSs that have handled this message. If you want to read the full rout- 
ing, use the RH command to read the message with all the headers displayed. 


This concludes the section on PBBS mode of operation. 
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GPS NMEA Interfacing Capability 


Most Kantronics TNCs, e.g. KPC-3 Plus, KPC-9612 Plus, KAM Plus, and others, 
support the GPS mode, explained below. Each contains firmware to interface 
with a GPS device supporting the NEMA-0183 interface standard; commands to 
configure and control unproto (path) retransmissions of the NEMA strings, and 
provides RAM storage for location messages (strings) for later retrieval. 


+ Among Kantronics’ TNCs supporting GPS, the only difference between devices 
is the number of radio ports available for transmission of data. For example, the 
KPC-3 Plus is a single port device and the KPC 9612 Plus is a multi-port device. 


Overview 


The Global Positioning System (GPS) was developed initially for military use by 
the U.S. Department of Defense, to provide worldwide positioning and naviga- 
tional information for U.S. military forces. Since then, a broad range of commer- 
cial, civilian, and amateur radio applications have been developed, based on the 
GPS. The GPS consists of 24 satellites each of which transmits positioning in- 
formation continuously. GPS receiving units - devices that contain a receiver, 
LCD display, and (usually) a data port - collect this positional information and 
use it to compute position. This information can then be retransmitted by any 
means possible to report the position of the GPS unit (and its vehicle). 


Most GPS units sold today are NMEA compatible. That means that not only can 
they display latitude, longitude, and time on an LCD screen, but the information 
can be presented to your computer or TNC via the GPS unit’s serial data port. 
The information is presented in ASCII in the form of NMEA “sentences”. A 
number of these sentences are available — with varying kinds of information, but 
the one used most often for amateur radio activities is “$}GPGGA”. This sentence 
contains latitude, longitude, altitude, and time (in UTC, derived from the satellite 
clocks). The TNC, in GPS Mode, can receive and retransmit this information as 
beacons and/or store these sentences in a large tracking buffer for later retrieval. 
The TNC, in GPS Mode, also updates its clock to UTC, derived from the satel- 
lites. Hence, the location of your remote packet station, recorded at a specific 
time, can be tracked by other packet stations. 


Amateurs the world over have discovered GPS and are combining this exciting 
new technology with packet radio for reporting the position of their vehicles, fol- 
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lowing balloon launches, finding hidden transmitters, and determining location 
information for more serious applications as well. A typical amateur location- 
reporting system consists of GPS-packet equiped vehicles and fixed-location 
packet repeaters. At a minimum, each vehicle would carry a GPS receiver, a 
packet unit (TNC), and a transmitter. Each TNC, in GPS mode, would be set to 
beacon location periodically. The fixed-location digipeaters would relay the 
reporting stations’ locations over a wide area. For more details on setting up such 
a system, see the next section, on “Advanced Digipeating.” 


GPS Equipment Requirements 


To set up a packet GPS station that can be tracked, you’II need the following 
equipment: 


e atransceiver and antenna, 
e A Kantronics’ TNC that supports the NEMA-0183 interface standard. 


e aGPS unit with an NMEA interface and portable or external antenna. 
More than 50 vendors produce GPS units and most offer NMEA data 
interfacing which is essential. 


+ Over time, a number of software programs will be developed by amateurs to use 
packet and GPS. One shareware program that has emerged already is the Auto- 
matic Packet Reporting System (APRS), written by Bob Bruninga. An APRS 
system may consist of a GPS unit, a computer, and (optionally) a packet unit. In 
APRS, NMEA data, from a GPS unit, is passed to the computer, and it is the 
computer’s job to display the information and, if desired, transmit that location 
via a packet unit using unproto packets. 


+ In some applications, you may wish to keep your PC or terminal attached to the 
TNC for packet operations, yet switch serial port connection to the GPS unit peri- 
odically — just to update your location. This arrangement is handy when only 
one COM port is available on your PC. This can be accomplished with a 
Kantronics APRS-HSP cable and APRS software. 
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Cabling a GPS Unit to a Kantronics TNC 


The NMEA standard specifies that the signals in the GPS receiver data port fol- 
low the EIA-422 standard. 


Technical note: Many GPS vendors simply use “TTL” voltage levels (+5 volts and 
0 volts), but use the same polarity as RS-232. These units are capable of driving a 
Kantronics TNC RS-232 serial data port input pin. However, some GPS vendors in- 
vert the sense of this signal (true TTL), and these units will not directly interface 
with a TNC. 


Warning: The Kantronics TNC serial ports are RS-232; that is, they provide for 
signals that swing plus and minus approximately 8 volts. Check your GPS manual 
before connecting this port to your GPS device to make sure that it is capable of 
handling these voltages. Kantronics is not responsible for damage wherein its 
TNCs are attached to other devices; see the Kantronics Limited Warranty. 


To connect the data port of a GPS unit to your TNC, you’ll need a three-wire ca- 
ble. A shielded cable is preferred. Refer to your GPS manual to determine which 
pins are used for signal ground, data output to an RS-232 device, and data input 
from an RS-232 device (such as the TNC). At least two of these wires must be 
connected at both ends of the cable: 


e connect the signal ground wire of the GPS data port to pin 7 of the TNC 
serial port. This wire may be identified as “NMEA-” by some GPS 
vendors. 


e connect the “data output pin” of the GPS data port to pin 2 of the TNC 
serial port. The data output pin may be identified as “NMEA+’” by some 
GPS vendors; this is the line that supplies the NMEA sentences to your 
TNC. 


Some GPS units may allow for programming of parameters. If so, this is accom- 
plished by passing commands to the GPS unit from a terminal (or TNC) via an 
additional pin in the data port. 
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If your GPS unit accepts the setting of parameters, you may wish to connect the 
third wire of your cable from the input data pin of the GPS data port to pin 3 of 
the TNC serial port. Again, consult your GPS manual for the name of this pin; 
names vary by vendor. Also, make sure this pin will accept an RS-232 signal 

(+ and - voltages). 


Setup: Configuring a Kantronics TNC for GPS Operation 


To configure your Kantronics TNC in GPS Mode you must set several command 
parameters from your PC keyboard as follows: 


e select the GPS strings you will be capturing in each of the Location Text 
buffers 


e set the beacon rates for each Location Text buffer you are using 
e enter the unproto paths for each Location Text buffer you are using 


You determine which GPS strings will be stored in the Location Text (LT) buffers 
by entering the string header with the GPSHEAD command. The TNC searches 
for specific strings of data from the GPS unit and stores them in up to four LT 
buffers. These LT buffers may then be transmitted at periodic intervals as a bea- 
con. The frequency of the beacons is controlled independently for each LT buffer, 
by the BLT command (which stands for Beacon Location Text). You may also set 
the destination address and the path for each of the four LT beacons independ- 
ently using the Location Text Path (LTP) command. 


+ Ifthe GPSHEAD string for any LT buffer is empty, that LT buffer can be set up 
an an auxilary beacon; LT, BLT, and LTP are used like BTEXT, BEACON, and 
UNPROTO. 


In addition to transmitting the beacons periodically, your TNC can store the 
transmitted beacons in a location buffer (LTRACK) for later review. The size of 
the LTRACK buffer is set by a command from the keyboard. 
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Setting Parameters in the TNC 


+ To add GPS capability to your portable packet station, enter the required GPS pa- 
rameters into your TNC (from your PC), set ABAUD to 4800, and then cable 
your TNC to the NMEA data port of your GPS unit. 


Note. Most GPS units have a fixed NMEA data port rate of 4800 baud; however, 
some advanced units allow other baud rates. 


To set up your TNC for GPS operation, you must first be communicating with it 
via your terminal in the normal mode (Command Mode or with a Host Mode pro- 
gram). 

First, set the GPSHEAD command to capture specific sentences from the GPS 
unit. You can set up to four strings to be stored (one each) in the LT buffers. The 
command would be GPSHEAD n string where n is the LT buffer number, and 
string is the name of the GPS string to be stored. 


For instance, if you want the TNC to store the $GPGGA string in LT buffer num- 
ber 1, use the command: 


GPSHEAD 1 SGPGGA 


In order to beacon an LT buffer, you must set the LTP and the BLT commands for 
that LT buffer. Full details of the LTP and BLT commands can be found in the 
commands section, but here’s an example of how they could be used: 


If you want LT 1 to beacon with a path of GPS via a digipeater (called DIGI), 
and you want the beacon to occur every 30 minutes, use the following com- 
mands: 


LTP 1 GPS via DIG 
BLT 1 EVERY 00:30:00 


+ Several amateur groups, such as APRS (see the bibliography at the end of the 
GPS section), have developed special programs for enhancing amateur GPS ac- 
tivities. Check with them for current practice in setting GPS beacon paths, bea- 
con rates, and frequencies used in your area. 


You can also set up a “tracking buffer” to store the most recently transmitted LT 
information for later retrieval. The size of the buffer and which LT buffers to 
store, is controlled by the LTRACK command. For instance, the command 
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LTRACK 5 LT1 LT2 


would set the size of the LTRACK buffer to approximately 5 Kbytes and store 
the LT 1 and LT 2 buffers whenever they are transmitted (as set by the BLT com- 
mand). 


GPS Unit Initialization from the TNC 


Some GPS receivers require reception of a special string of characters for initial- 
ization before they will send any information. You can tell your TNC to send the 
initialization string to your GPS unit by entering the required string using the 
GPSINIT command. For instance, if your GPS receiver requires the string 
$PGRMO,GPGGA, | to be sent, you would give the command 


GPSINIT $PGRMO, GPGGA, 1 


to your TNC. Upon power up, the TNC will then send that string via its serial 
port to the GPS unit (when the TNC INTFACE command is set to GPS.) 


GPS Operations 
Starting the TNC in GPS Mode 


+ Hint: Be sure to set ABAUD rate to that required by your GPS unit. 


Once you have the TNC parameters set for GPS, you need to set the TNC to start 
in GPS Mode on power up. To do this, set the INTFACE command to GPS. 
When the TNC resets (either from a RESET command or by turning the TNC off 
and then on) it will be in the GPS Mode, and the GPSINIT string (if any) will be 
sent to the serial port. 


Normally, you would set the INTFACE command to GPS, turn the TNC off, con- 
nect your GPS unit, and then turn the GPS unit ON and then turn the TNC ON. 


When operating in the GPS Mode, the TNC will automatically update the LT 
buffers every time it receives the designated NMEA strings from the GPS re- 
ceiver. 
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Exiting GPS Mode 


If you want to exit the GPS Mode (perhaps to set new parameters), connect your 
computer or terminal to the serial port of the TNC and type three <Ctrl+C> char- 
acters. The TNC will reset and the INTFACE command will be set to TERMI- 
NAL. 


+ Hint: You may have changed the ABAUD setting (usually to 4800) for the GPS 
mode. If so, before you can use the three <Ctrl+C> characters to exit GPS mode, 
you must set your RS232 baud rate in your computer to the same as the ABAUD 
setting in your TNC. 


Other GPS Features 


Slotted Beacons 


The BLT command provides for the ability to specify not only the interval be- 
tween beacons, but a starting time for the beacons. This permits a “slotted” sys- 
tem of beacons by numerous stations. For instance, lets say your local area has 30 
stations that each should beacon their location every 30 minutes. A beacon would 
be transmitted every n minutes from the time the user sets the time that the bea- 
con should be transmitted. As an example, if you set the BLT command for LT 1 
(BLT 1) with the command: 


BLT 1 EVERY 00:30:00 START 00:00:01 


the TNC would transmit a beacon at 00:00:01 (time after midnight) and every 30 
minutes after that. The second user could set the BLT with the command: 


BLT 1 EVERY 00:30:00 START 00:01:01 


In this case, these two users would never beacon at the same time, in fact they 
would beacon | minute apart. Using this system for our example, it is possible to 
set all thirty users to beacon one minute apart, avoiding collisions. 
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Tracking Without Beacons 


You may configure the TNC to store the LT “beacons” in the LTRACK buffer 
without transmitting the beacons. To do this, set the LTP to NONE for the associ- 
ated LT buffer: 


LTP 1 NONE 


When the destination call (path) is set to NONE, the TNC will not transmit the 
beacon, but since the BLT command is still active, the data will be stored in the 
LTRACK buffer. 


Remote Access and GPS 


When the TNC is in GPS Mode, the serial port is expecting data only from a GPS 
unit, hence, it cannot process any “normal” commands. Should you need to 
change any of the TNC commands, however, there are two options: 1) exit the 
GPS Mode using a terminal, or 2) connect to the TNC remotely by radio 
(MYREMOTE) and change the commands. 


When you connect remotely to the TNC (and properly respond to the password 
security check) you can change any parameters including the GPS parameters. 
You may also wish to send a command string to your GPS unit. This is accom- 
plished with the RPRINT command. For example, to send the string 
$PGRMO,GPGSA, | to the GPS unit, connect to the MYREMOTE of the TNC, 
verify the password, and send 


RPRINT SPGRMO,GPGSA, 1 


to the MYREMOTE. The TNC simply sends this string to its serial port (which is 
connected to the GPS receiver). 


Other Notes 


The LT buffers, LT beacons and LTRACK buffer can be used even without a 
GPS unit attached. You can manually set the LT buffers to any text you want (up 
to 128 characters total) using the LT command: 


LT 1 This is ltext buffer number 1 
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The LT buffers will be transmitted based on the BLT and LTP commands and 
stored according to the LTRACK command even when the TNC is not in GPS 
Mode. 


GPS Command Summary 


The following GPS commands are listed here for convenience and explained in 
detail in the Command Reference section. 


BLT n {EVERY | AFTER} hh:mm:ss [START hh:mm:ss] 
(n = 1 - 4) 


This command sets the interval between beacons for the associated LT string. 


GPSHEAD n string (n=1-4) (string up to 8 chars) 


This command determines which GPS NMEA sentences will be stored in the LT 
buffers. 


GPSINIT string (string up to 128 characters) 


This command establishes a string that will be sent to the attached GPS unit upon 
power-up (i.e., initial text sent to terminal in GPS Mode). 


LT on text (n = 1-4) (text up to 128 chars) 


This command fills the specified location Text (LT) buffer with “text”. 


User’s Guide 144 KPC-3 Plus v 8.2 


GPS NMEA Interfacing Capability Modes of Operation 


LTP n dest [via calll[,call12,...]] (n=1-4) 


This command sets the destination callsign and the digipeaters used to transmit 
the LT strings. 


LTRACK n [LT1] [LT2] [LT3] [LT4] [SYSOP] [TIME] 


This command allocates memory for a special tracking buffer used to store LT 
messages. 


PRINT text (text up to 128 characters) 


This is an immediate command which sends the “text” string from the serial port 
of the TNC to the attached device (e.g. GPS unit). 


Also, see the GPS setting for the INTFACE command. When this command is set 
to GPS, the TNC will enter GPS mode upon power up. Data from the serial port 
will be parsed according to the GPSHEAD command, text will be placed into the 
LT buffers, and beacons will be transmitted according to the setting of the BLT 
commands. 


+ Hint: To have the TNC exit GPS Mode, connect a PC or terminal to it and issue 
three <Ctrl+C> characters. 


Advanced GPS (or APRS) Digipeating 


The “UI” digipeating commands described in this section add flexibility in re- 
porting GPS (or APRS) station positions. It is an established prodedure of the re- 
porting stations to digipeat with generic callsigns and through a number of 
repeaters (e.g., “APRS” repeaters). In this way, reports of their positions can 
reach out, via a number of digipeaters, to any wide area. At the same time, the 
digipeaters supporting these activities must establish their TNC parameters such 
that all UI frames “copied” are digipeated often enough (enough repeats of each 
frame), but not too often (too many repeats of each frame), to achieve the desired 
result. 
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The commands introduced here (i.e., UIDIGI, UIFLOOD, UITRACE, and 
UIWAIT) allow each digipeater owner a wide range of ways in which to config- 
ure their TNC (in cooperation with other digipeaters in a network, who all need 
to work together) to establish an optimum GPS (or APRS) repeating network. 


+ Note: This section assumes you are familiar with GPS, digipeating, and APRS 
(each topic is discussed elsewhere in this manual). For details about APRS 
(A Packet Reporting System) developed by Bob Bruninga, WB4APR, consider 
obtaining a copy of “Getting On Track with APRS,” by Stan Horzepa, 157 page 
paperback, published in 1996 by the ARRL, 225 Main Street, Newington, CT 
06111. 


Amateurs are using GPS receivers, a packet unit, and an FM transmitter to report 
the location of their vehicles or stations to others. Their broadcasts use one-way 
(unproto UI) packets, reporting call sign, latitude and longitude. Packet stations 
hearing these broadcasts can monitor the location of the vehicles. 


A common goal of these position reporting stations is to digipeat a UI packet 
over a wide area (or a long distance), while moving though areas where the local 
callsigns may be unknown. An effective solution for not knowing local callsigns 
is to establish standard generic callsigns for digipeating stations and then use 
these names in digipeating paths. Of course, this requires the acceptance and use 
of standards for naming and using digipeating stations, by both the position re- 
porting stations and the digipeating stations. 


+ Common standards have been established by some local APRS groups, with 
names such as RELAY, WIDE, and TRACE. We encourage you to contact your 
local GPS (or APRS) interest group before configuring your TNC with its new 
digipeater capabilities. Usage may vary by area. 


Improving Efficiencies of Advanced Digipeating 


As described above, mobile location reporting stations are using digipeating 
paths containing generic digipeating names (e.g., RELAY, WIDE, TRACE) to 
extend their range of reporting. Using generic digipeating enables a mobile sta- 
tion to use the same digipeating path as it moves around, since there will (pre- 
sumably) always be nearby GPS (or APRS) digipeating stations with one or more 
of these generic names to pick up transmissions (i.e., UI packets) and re-transmit 
them to a wider area. 
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Using generically named digipeaters does result in wider coverage of GPS sta- 
tions, but several inefficiencies may arise from this common practice (depending 
upon the availability and names of the digipeaters). 


Among the problems that may arise in this situation are that: (1) UI packets can 
be repeated much more than necessary, by the same or by different digipeating 
stations with the callsigns RELAY, WIDE, or TRACE clogging up the airwaves, 
and that (2) several stations may re-transmit the same packet at the same time, re- 
sulting in a combined signal that cannot be copied by other stations. 


Kantronics’ TNCs (v. 8.2) have a suite of UI digipeating commands that can be 
used to deal with inefficiencies that can arise when a number of digipeaters are 
transmitting in the same area, at the same time, using the same generic names. 


Overview of UI Digipeating Commands 


The following UI digipeating commands support advanced GPS (or APRS) 
digipeating capabilities. 


The UIDIGI command may be used to set up to four additional aliases/call signs 
for “special” digipeating service. To-be-digipeated packets received containing 
one of these aliases will be repeated (once) with the call sign (MYCALL) of the 
digipeater substituted for the alias in the digipeated frame. See the example 
shown below and the command description for more detail. 


UIFLOOD and UITRACE are a bit more exotic. Each provides for multi-hop 
digipeating with just one digipeater address per packet, thereby keeping the trans- 
mission time short. For example, to digipeat through three TNCs supporting the 
UIFLOOD command, the reporting station might set a GPS position path as fol- 
lows: 


LTP 1 GPS via wide3-3. 


A digipeater TNC supporting “wide” set by the UNIFLOOD command and hear- 
ing the reporting station’s transmission would then digi the UI location packet 
(assuming it had not done so already, within a preset time), using an address of 
wide3-2. In turn each similar digipeater down line would digi the reporting sta- 
tion’s UI packet and reduce (decrement) the ssid of the digipeater address again. 
A TNC using UIFLOOD has the option of inserting MYCALL, creating two 
rather than one digipeater addresses in each transmitted digi packet. 
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With UITRACE, each time a packet is digipeated, each TNC adds its MYCALL, 
thus creating a “trace” or return path. In effect, the size of the packet grows by 
one digipeated address with each hop. A paramater, n, sets a delay time “do not 
digipeat within n seconds.” Again, see the examples below and the command de- 
scriptions for detail. 


The current setting of UIDWAIT determines whether or not a delay is added to 
UI digipeat packets (those formed by UIDIGI, UIFLOOD, or UITRACE) before 
transmission, once the channel is clear. If UIDWAIT is ON, the delay is deter- 
mined by slottime or persist settings. 


The purpose of the UIGATE (which is in multi-port devices only) is to prevent 
heavy high speed UI frame activity from congesting (“flooding”) the low speed 
(port 1) frequency. 


Each of these commands is documented in the ‘““Command Reference”. 


Note: Digipeater priority for call signs is as follows: UIDIGI, UIFLOOD, 
UITRACE, MYCALL, MYNODE, MYALIAS (e.g. if you assign the same call 
sign to UIDIGI and MYALIAS, a to-be-digipeated frame with that call sign will be 
digipeated according to the rules that apply to UIDIGD). 


Using “UI” Digipeat Commands: UIDIGI, UIFLOOD, and 
UITRACE 


The following are actual monitored outputs of a lab system consisting of one po- 
sition reporting station and three digipeaters, where each digi is configured using 
the UIDIGI, UIFLOOD, or UITRACE command and where UIDWAIT is set 
ON. We set UIDWAIT ON to force the system to digipeat all or most of the UI 
frames without collision. In all examples, the reporting station, WOXI, is used to 
launch a UI packet with the path set by the UNPROTO command. 


With UIDWAIT OFF, several digipeaters would transmit at the same time, result- 
ing in corrupted packets. In actual on-the-air use, a system of digipeaters may 
work well with UIDWAIT OFF, depending upon their mix of location and trans- 
mitter power. 


+ In actual use, GPS (or APRS) reporting stations would set their path with the LTP 
command. 
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Configuring Three Digis Using the UIDIGI Command 


Here, three digis, with MYCALLs of A, B, and C, are configured with aliases of 
RELAY, WIDE, and TRACE (using UIDIGI); and UIDWAIT is set ON. For ex- 
ample station A’s UIDIGI aliases are set as follows: 


cmd: UIDIGI ON RELAY, WIDE, TRACE 


The reporting station path is then set to GPS via RELAY, WIDE, TRACE, and a 
UI packet is launched. 


Any one of the stations monitoring will then display the resulting action as fol- 
lows: 


cmd: W2XI>GPS, RELAY,WIDE, TRACE: <UI>:5 
WOXI>GPS,B*,WIDE, TRACE: <UI>:5 
WOXI>GPS,A*,WIDE, TRACE: <UI>:5 
WOXI>GPS,B,A*,TRACE: <UI>:5 
WOXI>GPS,A,B*, TRACE: <UI>:5 
WOXI>GPS,C*,WIDE, TRACE: <UI>:5 
WOXI>GPS,B,C*, TRACE: <UI>:5 
WOXI>GPS,A,C*, TRACE: <UI>:5 
WOXI>GPS,B,A,C*: <UI>:5 
WOXI>GPS,A,B,C*: <UI>:5 
WOXI>GPS,C,A*, TRACE: <UI>:5 
WOXI>GPS,B,C,A*: <UI>:5 
WOXI>GPS,C,B*, TRACE: <UI>:5 
WOXI>GPS,A,C,B*: <UI>:5 
WOXI>GPS,C,A,B*: <UI>:5 
WOXI>GPS,C,B,A*: <UI>:5 


All digis hear the first UI frame and store it. Due to the setting of UIDWAIT, 
some stations may wait longer than others to digipeat; hence, when they do, they 
may have several frames stored up - for example, the original and a digipeat from 
another station. Trace station B as an example. It digipeats the original UI frame 
from the “reporting station,” swapping its MYCALL for RELAY (B) and mark- 
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ing it (*), then repeats a frame from A and one from C, and, finally, repeats two 
more (from A,C and C,A) — a total of five! Note that each repeater digis five 
times so the total number of digipeated packets is 15! 


Configuring Three Digis Using the UIFLOOD Command 


Here, three digis, with MYCALLs of A, B, and C, are configured with an alias of 
WIDE, and UIDWAIT is set ON. For example station A’s UIFLOOD call is set 
as follows: 


cmd: UIFLOOD wide, 30,1D 


The reporting station path is then set to GPS via WIDE4-4, and a UI packet is 
launched. Any one of the stations monitoring will then display the resulting ac- 
tion as follows: 


WOXI>GPS,WIDE4-4: <UI>:5 

WOXI>GPS,A*,WIDE4-3: <UI>:5 

WOXI>GPS,B*,WIDE4-3: <UI>:5 

WOXI>GPS,C*,WIDE4-3: <UI>:5 
Note that all three digis see the UI frame addressed to GPS via WIDE4-4. They 
then, in turn digipeat that frame, inserting and marking as digipeated (*) their 
MYCALL, and include the new to- be-digipeated and decremented field of 
WIDE4-3. Note that each digi hears the UI frames repeated by the others but 
does not digipeat those in turn since a timeout of 30 seconds was specified by the 
UIFLOOD command. See the command specification for details. 


Configuring Digis Using the UITRACE Command 


Here, digipeaters A, B, C, and D are set with UITRACE trace, 30. Digipeater B 
then launches a UI frame using UN GPS via TRACE4-4. The following results: 


B>GPS, TRACE4-4/1<UI>:QWER 

B>GPS,A*, TRACE4-3/1:<UI>:QWER 
B>GPS, D*, TRACE4-3/1:<UI>:QWER 
B>GPS, C*, TRACE4-3/1:<UI>:QWER 
Stations A, D, and C hear B and digipeat the UI frame, inserting their MYCALL 


and decrementing the SSID of trace. A does not re-digipeat D or C because its 
“n’” timer is set to 30 seconds, that is, it will not repeat any frame again within 
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that time that includes the same source or destination and data (in this case 
QWER). 


Configuring Digis for HF/VHF Gateway Operations 


+ This example assumes the use of at least one multi-port TNC that supports both 
HF and VHF operation. 


In this example, we demonstrate cross-band (gateway) digipeating, using selected 
Kantronics TNCs. A UI frame is launched on HF and repeated on VHF four 
times. A KAM Plus and two KPC-3 Pluses (with call signs C, B, and D) are con- 
figured as digipeaters and another KAM Plus (call sign A) is set to launch a UI 
frame from its HF port. The digis are configured with an alias of FLOOD and 
UIDWAIT is set ON. In addition, MYGATE for digi C (the KAM Plus) is set to 
C-3 and its UIGATE is set ON/OFF; that is, it is enabled to digi from HF to VHF 
but not from VHF to HF. The KAM Plus, with call sign A, is then used to initiate 
an unproto packet with the path GPS via C-3, FLOOD4-4. Either KAM Plus will 
then display the resulting action as follows: 


A>GPS,C-3,FLOOD4-4/H: <UI>:234 
A>GPS,C-3*, FLOOD4-4/V: <UI>:234 
A>GPS,D*, FLOOD4-3/V: <UI>:234 
A>GPS,C*,FLOOD4-2/V: <UI>:234 
A>GPS,B*, FLOOD4-3/V: <UI>:234 


Station C hears the HF unproto packet of station A and digipeats it via its GATE- 
WAY out its VHF port. Digis B and D hear the VHF UI packet and store it for 
digipeating, and D transmits first. In turn station C hears station D’s repeat of the 
frame and digipeats the frame, decrementing flood to “FLOOD4-2.” It didn’t 
digipeat its own “FLOOD4-4" frame because it can’t hear itself! Station B fin- 
ishes last due to the slot/persist algorithm. D digipeats the frame only once even 
though it hears both B’s and C’s transmissions since they are within 30 seconds 
of it’s own transmission. 


KPC-3 Plus v 8.2 151 User’s Guide 


Modes of Operation GPS NMEA Interfacing Capability 


Bibliography 
For more information on the Global Positioning System, we recommend the fol- 
lowing resources: 
General Information 


Bruninga, Bob, WB4APR, “Automatic packet reporting system (APRS)”, /3th 
ARRL Digital Communications Conference Proceedings, 1994. (address: ARRL, 
225 Main Street, Newington, CT, 06111). 


Horzepa, Stan, “Getting On Track with APRS,” ARRL (225 Main Street, New- 
ington, CT 06111) 1996. 


Sproul, Keith, WU2Z, “MacAPRS”, /3th ARRL Digital Communications Confer- 
ence Proceedings, 1994. 


Technical Information 
Collins, J., et al., GPS Theory and Practice, Second Edition, Springer-Verlag, 1993. 


Etherington, Michael, “FM subcarrier network extends differential GPS nationwide”, 
Mobile Radio Technology, February 1994. 


Kaplan, Elliot, “The global positioning system (GPS)”, Communications Quarterly, Sum- 
mer 1994. 


Langley, R., “The mathematics of GPS”, GPS World Magazine, July/August 1991. 


“NMEA 0183 ASCII Interface Standard”, (NMEA 0183 version 2.0), NMEA, P.O. Box 
50040, Mobile, AL 36605. 


Vendors Supplying GPS Units 
Some of the more than 50 vendors currently supplying GPS units include: 
@ Garmin, 9875 Widmer Rd., Lenexa, KS 66215 
@¢ ICOM America, Inc., 2380 116th Ave. N.E., Bellevue, WA 98004. 
e Magellan Systems Corp., 960 Overland Ct., San Dimas, CA 91773. 
e Sony Electronics Inc., 1 Sony Dr., Park Ridge, NJ 07656. 


e ~=Trimble - Mobile Computing Products, 645 N. Mary Ave., P.O. Box 3642, 
Sunnyvale, CA 94088-3642. 
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KA-Node 


Overview 


Most Kantronics TNCs (e.g., KPC-3 Plus, KPC-9612 Plus) include, as a part of 
their firmware, the Kantronics KA-Node, a packet networking node. If you turn 
this node on, others may use your station (unattended) not only as a digipeater 
but as a node, enabling them to find pathways to other stations and making those 
pathways more efficient. 


KA-Nodes, like other networking nodes such as NET/ROM, operate more effi- 
ciently than do digipeaters as a link between two stations. End-to-end acknowl- 
edgement of received packets is not required with the nodes; instead they handle 
errors beween each other, rather than from end to end (which can cause extra 
traffic when errors or interference occurs). A KA-Node, however, is “silent” in 
that it does not automatically connnect to and exchange routing data with adja- 
cent nodes, as do fully-features nodes such as NET/ROM, X1J, or Kantronics op- 
tional K-Net. Consequently, users cannot issue a connect to a distant station 
without knowing the path - as they sometimes can with a fully-featured node. At 
the same time, KA-Nodes are useful in that they are more efficient than 
digipeaters in using channel time, while not requiring the effort and time required 
to maintain a full node. 


When packet got started in the early 1980s, the initial packet units - terminal 
node controllers (TNCs) - were designed and coded not only to accept sta- 
tion-to-station connects, but to act as digipeaters for other stations. It was the 
first 

attempt at packet radio networking, linking two stations together via several oth- 
ers. It soon became evident, however, that digipeating, particularly through busy 
channels, was an inefficient method of linking two stations via others. First of all, 
the station initiating the “connect” had no way to know ahead of time whether or 
not the digipeating stations were available. Second, the AX.25 protocol called for 
the station being connected to - at the end of several digipeaters - to acknowledge 
each packet of the initiating station. Packets not acknowledged (due to collisions) 
had to be retransmitted by the initiating station AND ALL DIGIPEATERS in the 
communications chain. As a result, communication often ground to a halt when 
channels were busy. 
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To solve these problems, NET/ROM, a PROM-based networking program that 
installed inside some TNC models, and a number of derivatives of NET/ROM 
(e.g., G3BPQ, X1J, KA-Node, K-Net) were developed. These networking pro- 
grams provide the user connecting to a station via one of these nodes with a 
choice of pathways to other packet stations and with lists of stations heard. 
NET/ROM and several of its derivatives provide for automatic routing of your 
connect request - much like the phone system today routes your long distance 
calls. Others, such as the KA-Node, assist you in building a pathway by allowing 
you to connect to each node in turn through the pathway. All of the nodes correct 
the “end-to-end” acknowledgment problem mentioned above. This is accom- 
plished by building the pathway with a number of individual “local” connecting 
links; that is, each link in the pathway is considered a connect and all acknowl- 
edgments of packets are kept local. Hence, if only one link of a pathway (chain) 
is troublesome, the local nodes take care of it. 


The following material is provided to assist you in configuring your KA-Node 
and telling others how to connect to and use it. A listing of the node commands 
for users follows. 


Configuring Your KA-Node 


The following commands are used to configure your KA-Node: NUMNODES, 
MYNODE, NDWILD, and KNTIMER. 


In order to set your TNC for use as a KA-Node several conditions must be met. 
First, you must allocate the number of circuits (channels) you wish to allow 
through the KA-Node (see NUMNODES). Each circuit consists of an “IN” and 
an “OUT” side. Secondly, the callsign assigned to the KA-Node (MYNODE) 
must be different from the callsign used for you (MYCALL), your alias 
(MYALIAS), the PBBS (MYPBBS), and remote access (MYREMOTE). By de- 
fault, your TNC has set MYNODE to your callsign with an SSID of -7. 


+ To cause your KA-Node to accept a connect request to any SSID of the 
MYNODE callsign (except those mentioned above), set the NDWILD command 
ON. 


Packets passing through your KA-Node are monitored unless your MYNODE 
callsign is included in the SUPLIST, if turned ON. If it becomes necessary to dis- 
connect a station from your KA-Node, you can issue the command DISCON- 
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NECT MYNODE x (x = channel) from the local terminal connected to your 
TNC. 


If no data passes through an established (connected) KA-Node circuit for n min- 
utes, where n is set by “KNTIMER”, then that circuit will be disconnected. The 
default time is 15 minutes but you can disable this by setting n to 0. 


Each KA-Node circuit allowed will require approximately 4.3K of memory. If 
you attempt to set NUMNODES to a value requiring more memory than avail- 
able, you will receive a message indicating that the value is out of range. The to- 
tal number of circuits which may be allocated will also be affected by the amount 
of memory allocated to the Personal Mailbox. 


+ Some Kantronics TNCs, such as the 9612 Plus, are multi-port. These multi-port 
KA-Nodes can support cross-connects, Xconnects; that is, users may connect on 
one port and then connect out another port, which may be attached to another 
radio set to a different frequency. 


Using a KA-Node 


+ The material that follows is meant for those using your KA-Node, i.e. connecting 
to it. You may use this material as a guide to using someone else’s node or in 
connecting to your own node from another location (car, another station, via a 
digi, etc.). 


To use the KA-Node as a means of connecting to some other node or end-user, 
you must first connect to the KA-Node. At the cmd: prompt on your TNC, issue 
a connect request to the callsign of the KA-Node, let’s say it’s been named LAW. 
When you make connection you will see the following messages on your display: 


*** CONNECTED TO LAW 
### CONNECTED TO WILD NODE LAW (N@GRG) CHANNEL A 
ENTER COMMAND B,C,J,N,X, or Help ? 


The *** CONNECTED message is sent by your local TNC to your terminal, and 
the ### CONNECTED TO NODE message comes from the distant KA-Node. 
N@GRG is the MYCALL of the station containing the KA-Node in this example, 
WILD indicates that he is running a “wildcard” node, and CHANNEL A indi- 
cates that you have connected to its channel A. If A is in use, you may obtain 
channel B. The channels, or circuits, are assigned by the KA-Node as needed. 
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After connecting to the KA-Node, you are in CONVERS mode at your own sta- 
tion, and the KA-Node is waiting for a command. You issue a command to the 
node by STAYING IN CONVERS MODE. 


Note: The KA-Node will interpret the data you send as its commands. 


At this point, let’s assume that you wish to know what other KA-Nodes are 
nearby. You would issue the NODES command by typing N, or NODES, in re- 
sponse to the KA-Node “enter command” prompt. You will receive a list of 
KA-Nodes which have recently been heard. For example, let’s suppose that KC 
was heard by LAW. Your list received from the Nodes command would be: 


KC (N@APJ-2) 12/23/87 02:38:45 
ENTER COMMAND B,C,J,N,X, or Help ? 


KC denotes the KA-Node callsign (MYNODE), the MYCALL of the KA-Node 
station is in parentheses, followed by date and time heard. If LAW had heard 
nothing, it would respond with: 


NO KNOWN NODES 


You may, instead, wish to know what other stations the KA-Node has heard 
lately. This would be accomplished by sending a J for the JHEARD command. 
The node will respond by listing its own MHEARD log. The list will contain end 
user and node callsigns and is the same type of list you get by using your own 
MHEARD command at the cmd: prompt. 


At this point, let’s suppose that you would like to connect to the node called KC 
through your current connection with LAW. Just issue a connect request to KC as 
follows in response to the “enter command” from LAW: 


CONNECT KC 


The response will be: 


###LINK MADE 
###CONNECTED TO NODE KC (N@APJ-2) CHANNEL A 
ENTER COMMAND B,C,J,N,X, or Help ? 


At this point you are “patched” through the KA-Node LAW to the node KC. 
When LAW issued the connect request to KC it used your own call but sub- 
tracted a count of one from your SSID. For example, if you connected to LAW 
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with WOXI, LAW connected (via your request) to KC with WOXI-15. This is 
automatic. 


At this point, you could connect to another KA-Node, some other network node 
using AX.25 as an uplink or downlink protocol, or to an end-user. Let’s assume 
that you desire to connect to NOKN. So, just enter in response to the node “enter 
command” above: 


C NOKN STAY 
and you’ll get the response: 
###LINK MADE 
+ We'll explain the “STAY” later. 


You are now connected to NOKN. If you have issued a connect command to a 
KA-Node, and realize that you have made a mistake with the call, or for any 
other reason wish to cancel the connection, you may do so by using the ABORT 
command. In order for the abort to work, it MUST be the first word entered fol- 
lowing the connect command and must be spelled out entirely. For instance if 
you tell the KA-Node: 


C KBSEEG 


and then decide to abort the connect, your next entry must be: 
ABORT 


Any other entry will cancel any possible abort of the connection, and you must 
wait for the KA-Node to retry out (e.g., because it will try to connect to 
KBSEEG). 


Now that you are connected to NOKN, you can carry on a normal packet QSO. 
While everything appears “normal” and AX.25 compatible, acknowledgments to 
your packets are generated by the KA-Node directly connected to you. Each link 
in the chain/pathway takes care of its own errors. In other words, the link be- 
tween KC and LAW handles its own error checking. In this way, one weak link 
will not cause end-to-end packets and acknowledgments to be repeated as they 
would with digipeating. The result is substantial improvement in throughput for 
connections using nodes. 
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When it comes time to disconnect, you do so in the standard AX.25 manner. To 
disconnect the link described above, type <Ctrl+C>, obtain the cmd: prompt on 
your TNC, and issue the disconnect command: 


cmd: D 
** XD TSCONNECTED 


You’ll get the usual disconnect message from your TNC, as noted. If however, 
your distant partner, in this case NOKN, disconnects the link, you’II see the fol- 
lowing (due to the “STAY” in “C NO@APJ STAY” in the example earlier): 


###DISCONNECTED BY N@APJ AT NODE KC 
ENTER COMMAND B,C,J,N,X, or Help ? 


Frequently when connecting to a distant city, you may wish to talk to more than 
one station. Perhaps when you connected, you got a message saying “I’m not 
here right now, please leave a message in my PBBS”. By using the “S(tay)” 
option when telling a KA-Node to connect to another station, the KA-Node will 
not disconnect from you if it receives a disconnect from the distant station. In- 
stead, you will receive a message from the KA-Node saying ###DISCON- 
NECTED BY (call) AT NODE (MYNODE). In other words, if you connected 
from Lawrence, Kansas to a KA-Node in Lincoln, Nebraska, and then told that 
KA-Node to connect to someone using the command “C call Stay”. Then if that 
station sent you the above message and disconnected, you would remain con- 
nected to the KA-Node in Lincoln! This would allow you to issue a connect di- 
rectly to his BBS, without having to re-establish the entire path. 


In multiple KA-Node paths, each time you say B(ye) to the distant KA-Node, 
this will return you to the next previous KA-Node which had been told to “Stay” 
in the chain of KA-Nodes. From that point, you could build a path in a different 
direction. One point to note here is that if you use the KA-Node to connect to a 
BBS (W@RLI or WA7MBL for instance), and use the STAY option, then say 
B(ye) to the BBS, you would remain connected to the KA-Node closest to the 
BBS. If you issue the connect without the STAY option, any disconnect from ei- 
ther end will cause the entire link to disconnect. 
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Automatic Disconnect 


If a user abandons a connection to a KA-Node or a link between two KA-Nodes 
without disconnecting and there is no activity through the link for a specified pe- 
riod of time (see KNTIMER), the node will initiate a disconnect. 


Using the XCONNECT Command 


Note: The XCONNECT command is available only on Kantronics’ multi-port 
TNCs, such as the KPC-9612 Plus. Single-port TNCs (e.g., KPC-3 Plus) do not 


support this command, but they may connect to a KA-NODE that does. 


The cross-connect (XCONNECT) command is a unique feature of the KA-Node. 
This command allows cross linking between two frequencies through the node in 
much the same manner as the Kantronics unique gateway, but with local ac- 
knowledgment of packets. 


For example, suppose you just connected to node LAWKAN and wish to 
cross-connect to NOGRG whose station is tuned to the frequency of the other 
port of the node. Just issue X NOGRG following the the node prompt: 


ENTER COMMAND B,C,J,N,X, or Help 
X N@GRG <CR> 


The response you receive will be: 


### LINK MADE 
### CONNECTED TO N@GRG 


You can also determine from the response to the NODE command, which port a 
node is on. Below is an illustration of a KA-Node response to a NODE com- 
mand: 


LAWKAN* 12/02/87 15:45:00 
N66046/X 12/02/87 15:49:15 
OLAKAN/X 12/02/87 16:15:21 


In this typical display, the callsign of the node is given, followed by the date and 
time it was last heard. The “/X” indicates that the node was heard on the opposite 
port from the one you are connected on. The asterisk (*) means that the node was 
heard via a digipeater. 
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Determining Which Port You Have Connected To 


When you are connected to a multi-port node, you can determine which port you 
are on, at the node, by using the JHEARD command. A typical node response to 
the JHEARD command may appear on your display as shown (the KAM uses /H 
and /V instead of /1 and /2): 


N66046/2* 12/01/87 14:32:69 
N@KN-1/1 12/01/87 16:25:01 
WOX1/2 12/02/87 16:28:05 
N@GRG/1 12/02/87 16:32:09 


In this illustration the number following the slash (/) indicates the port the station 
was heard on. Your callsign will usually be the last one in this list. 


You can now see that by comparing the port on which your call appears in the 
JHEARD list to the port indicated for other stations, you can determine whether 
to CONNECT or XCONNECT to the station of your choice. 


KA-Node Commands for Remote Use 


When accessed by radio, the KA-Node supports several commands which may 

be given to it. These commands are listed here for reference, with a description of 
each command. In these descriptions, the UPPER case characters of the com- 
mand are required, while LOWER case characters are optional. Those items 
listed within [ ] are optional and if used the UPPER/LOWER case convention 
applies. 


ABORT 


Aborts a KA-Node Connect or Xconnect request if it is the first data sent after 
the connect request. It must be spelled out entirely. 


Bye 


Causes the KA-Node to initiate a disconnect. 
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Connect callsign [Stay] 


Causes the node to issue a connect request to “callsign” in the usual AX.25 
mode. If the connect is successful, a link will be made to the next node or 
end-user station called. The optional Stay feature provides a way to disconnect 
without loosing the entire link. Normally when a disconnect occurs, whether is- 
sued by you or by the remote station, the connection to the KA-Node is also lost. 
Using the Stay option allows you to stay connected to the KA-Node when the re- 
mote station issues a disconnect. 


Help 


Causes the KA-Node to send a brief help list, showing all commands available, 
with the options and a short description of each command. 


Jheard [Short|Long] 


Causes the KA-Node to transmit its MHEARD log. The returned list (without the 
short or long option) may look like this: 


(HF/VHF Multi-Port) 

LAWKAN/H* 01/09/88 08:25:15 
N66046/V 01/10/88 00:03:10 
N@KN-3/H 01/10/88 00:03:19 
N@GRG/V 01/10/88 00:04:15 


(VHF/UHF Multi-Port) 
LAWKAN/1* 01/09/88 08:25:1 
N66046/2 01/10/88 00:03:1 
N@KN-3/1 01/10/88 00:03:1 
N@GRG/2 01/10/88 00:04:1 


awoo un 


(Single-Port) 


LAWKAN 01/09/88 08:25:15 
N66046* 01/10/88 00:03:10 
N@KN-3 01/10/88 00:03:19 
N@GRG 01/10/88 00:04:15 
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The left column indicates the callsign (and SSID if appropriate) of a station 
heard. The character following the slash (/) shows the port on which the station 
was heard (single port TNCs don’t include a “/’’). The asterisk indicates the sta- 
tion was heard via a digipeater. The center and right columns indicate date and 
time the station was last heard. The last call on the list will probably be your call. 
The above JHEARD lists show N@GRG connecting to the KA-Node. 


The short (JHEARD S) version of this command would produce the same list, 
without dates and times. 


The long (JHEARD L) version of this command will also show the destination 
field and any digipeaters used. 


Nodes [Short|Long] 


Causes the node to return a list of KA-Nodes it has heard, as well as K-Net, 
G8BPQ, NET/ROM and TheNet nodes. The format of the list is similar to that of 
the JHEARD list above. 


Xconnect callsign 


Note: The Xconnect callsign command is available only in KA-nodes in 
Kantronics’ multi-port TNCs. 


Causes the node to issue a connect request to “callsign” (in the usual AX.25 for- 
mat) on the opposite port of the KA-Node. Cross-connecting enables you to gain 
access, via the node, to another frequency. 
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WEFAX Mode 


Overview 


Black and white weather facsimile charts, referred to as “WEFAX” by HF radio 
operators, have been transmitted by shore stations for years and received by com- 
mercial ships, yachts, and radio amateurs. By coincidence, the signal format used 
for WEFAX broadcasts, 800 Hz shift key (FSK), is compatible with the modem 
housed within most Kantronics TNCs (e.g., KPC-3, KPC-3 Plus, KAM Plus). In 
order to receive WEFAX charts, which are typically hand drawn maps of atmo- 
spheric pressure, surface temperature, or wind velocity/direction over a wide 
range of sea, you must use a special program (e.g. Kantronics’ Superfax I) for 
your computer. Such programs enable your PC to receive 8 bit data from the 
TNC and format it properly for display on your computer screen. 


These maps, unlike satellite photos with a full gray scale range, are often pro- 
duced by a particular weather service at their own site. Two predominant stations 
are NAM, the Norfolk US Navy Fleet Weather Service station, and CFH, the Ca- 
nadian Forces Halifax station. 


Background: HF WEFAX Transmissions and Resolution 


Full size charts are eighteen (18) inches wide and vary in length from 10 to 18 
inches. In past years, many charts were generated on a rotating drum at 60 scan 
lines per minute, but modern day charts are digitized (placed in computer stor- 
age) at the rate of 120 scan lines per minute on a flat-bed scanner. The scanner 
digitizes with a resolution of 96 lines or pixels per inch. So, the maximum resolu- 
tion of a hand-drawn synoptic chart, when digitized, is nearly 1800 by 

1800 pixels! 


When the WEFAX maps and charts are transmitted on HF, some of the resolution 
is lost. This occurs because the FSK modulation scheme used by all manufactur- 
ers of HF WEFAX transmission equipment will not support the baud rate needed 
for full horizontal resolution. The FSK format has been kept, however, to make 
today’s equipment compatible with that produced earlier, and received-map reso- 
lution is acceptable. 
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Finding WEFAX Broadcasts 


There are approximately 50 commercial and governmental WEFAX transmitters 
located in over 20 countries around the world. Most broadcast on HF (between 3 
and 30 MHz). Many broadcast continually while others are on a sporadic sched- 
ule. You will nearly always find the following if ionospheric conditions permit: 


LOCATION FREQUENCIES (MHz) 

Halifax, NS 4.275, 6.630, 9.890, 13.510 

Norfolk, VA 8.080, 10.865, 16.410 

San Diego, CA 8.646, 17.410 
9 
4 
4 


Mobile, AL 
San Fran, CA 
Washington, DC 


.346, 8.682, 12.730, 17.151 
.795, 10.185, 12.205, 14.672 


In addition, many of the frequency guides for sale by various radio equipment 
suppliers list WEFAX station frequencies. 


Tuning WEFAX Signals on HF 


WEFAX broadcasters use an 800 Hertz shift key ( FSK) format, using mark and 
space frequencies of 1500 and 2300 Hertz respectively. These tones, like voice 
broadcasts, are used to modulate the station RF carrier. You can tune these sig- 
nals with your standard 1200 baud packet modem by tuning about 1.7 KHz be- 
low the published station frequency in upper-sideband (USB). For example, with 
your HF transceiver or receiver set to USB, turn the dial until the frequency read- 
out shows 8078.3 to receive NAM (the Norfolk US Navy Fleet Weather Service 
transmitting on 8080 KiloHertz). 


Receiving WEFAX Transmissions 


To receive WEFAX you need to connect an audio cable from your HF receiver to 
the audio input of your TNC’s 1200 baud radio port. Be sure to read the docu- 
mentation that comes with your WEFAX program (e.g. Kantronics’ Superfax II) 
to learn how to use it. 
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The WEFAX Command 


To cause your TNC to enter the WEFAX Mode, you use the WEFAX command 
(and NOT the INTFACE Command). 


WEFAX n 


This command will cause the TNC to sample the audio input at n samples per 
second. The value of n is determined by the number of pixels (dots) which can be 
displayed across one line of your terminal screen in the graphics mode. For in- 
stance, if the PC computer you use has 640 dots across the screen and the 
WEFAX station is transmitting 2 lines per second (120 per minute) you should 
use an n value of 1280. These values keep your TNC in sync with the HF 
WEFAX transmitting station. If your WEFAX picture skews (is not squared up), 
adjust the TNC clock by using the command DAYTWEAK. The ABAUD rate of 
the TNC must be set to a value at least 5/4 the WEFAX n rate. This gives the ter- 
minal program time to display or store each pixel byte and to handle the extra 
start and stop bits added to each set of 8-bits at the serial port. 


Exiting WEFAX Mode 


To stop the sampling of WEFAX data and return to Command Mode, send a 
<Ctrl+C> to the TNC. 
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Other Modes of Operation 


Other ways of using your TNC are covered in this section. 


+ Some of the following modes of operation require special software, so they may 
not be available if you are using standard terminal programs such as Pacterm and 
Procomm Plus. 


Remote Sensing and Control 


You can use two (or more) packet radio stations, each containing a Kantronics 
TNC, to implement remote sensing and/or remote control, as follows: 


remote control of another TNC: from a local Kantronics TNC-based 
radio station, use the MYREMOTE command to establish control of a 
remote Kantronics TNC-based radio station and issue commands for the 
remote TNC to carry out. For details, see the Command Reference. 


sense analog inputs: use the ANALOG command to gather and report 
the status of one or two analog input lines in the remote TNC. 
Kantronics single port and multi-port TNCs contain an 8 bit A/D 
converter and additional circuitry that converts the analog voltage 
presented at two specified inputs into digital values from 0 to 255. You 
can then use these digital values (reported in binary) as an approximation 
of the analog voltage values at the time the TNC interrogated the analog 
inputs. For details on the ANALOG command, see the Command 
Reference. 


Note: As documented in the ANALOG command and the radio port pin 
spefications, single port devices and multiport devices use different input 
lines and ports for analog sensing. 


control output voltages: use the CTRL command to control the voltages 
on selected output lines in the remote TNC (up to two output lines in 
single port devices and four output lines in multi-port devices). Each of 
these output lines can be set to 5 volts (i.e., ON) or 0 volts (i.e., OFF) by 
the CTRL command. Also, the CTRL command can be used with any or 
all of these output lines to send a specified number of short ON/5 
volts-then-OFF/0 volts pulses (each pulse lasting about .1 second, with 
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a fixed length pause between pulses) or a single long (about 1.5 second) 
ON/OFF pulse. For details on the CTRL command, see the Command 
Reference. 


+ You can also use the ANALOG and/or CTRL commands, without the REMOTE 
command, to carry out sensing and control functions at a local Kantronics TNC. 


The following diagram illustrates the use of two Kantronics TNC/radio stations 
for remote control and sensing. These operations could be carried out manually 
or via a terminal program running in the computer in the central TNC station. 


Remote Sensing and Control 


Example: controlling the level of liquid in a tank 


Central OPERATING RULES forcontrolling the level of the liquid: 
' 1. If the level is "low" orless, tum the Pump ON. 
Kantronics 2. If the level is ‘full'ormore, tum the Pump OFF. 
INC Based 3. If the level is "too full'ormore, OPEN the Drain. 
Sta tion 4, If the level is "full" or less, CLOSE the Drain. 
a 
; Tank 
ri radio Too Full —» 
; connection 
between INCs Full - > 
Low ———» 
Remote Control line 1 (ON/OFF) pi Pump 
Kantro nic S Control line 2 (O PEN/C LOSE) pf Drain 
TNC Based — 
Sta tion A/D sensor line 1 Pressure 
Sensor 
(for level 
of liquid) 


As noted earlier, the Command Reference sections and sections of pin assigments 
provide details needed to adapt these broad capacities to your own situation, with 
your own sensors, controls, and remote locations. 
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Modem Mode 


In MODEM mode, the TNC demodulates the audio signal from the radio on port 
1 and passes this data through to its RS-232 port unmodified. No “protocol” ad- 
justments are made to the data; the TNC simply acts as a dumb modem. In other 
words, it simply reflects out the RS-232 port what it “sees” coming in the radio 
port. For example, if ASCII information is received at 1200 baud, the TNC pres- 
ents your computer with ASCII at 1200 baud. With a simple terminal program 
running at 1200 baud too, you’d be able to copy the text. 


To place the TNC in modem mode use the INTface command. At the cmd: 
prompt, type INT MODEM and return. Then turn your TNC power OFF and 
back ON. 


To leave modem mode, send three Ctrl+C (command) characters to the TNC at 
1200 baud. If ABAUD was set to something other than 1200, that setting will re- 
main after you exit modem mode. Hence it may be convenient for you to set the 
TNC to 1200 baud before entering modem mode. 


+ Note: Some computers may lose some of the data stream if a full RS-232 cable is 
used. This can occur because the RS232 CD line, which is “tied” to the TNC’s 
receive LED, may be cycling up and down. In this case, set CD to EXTERNAL 
before entering INT MODEM. 


Copying Weather Broadcasts NWS EMWIN 


MODEM mode can be used to copy emergency weather broadcasts by the Na- 
tional Weather Service. The NWS Emergency Managers Weather Information 
Network (EMWIN) is a wireless direct-to-computer information service that the 
National Weather Service (NWS) provides with help from the Federal Emer- 
gency Management Agency. The NWS feeds a constant stream of weather infor- 
mation (@ 1200,8,N,1), from around the world, to a satellite orbiting the Earth. 
Many cities are coming on line now to capture this stream and rebroadcast it on 
fixed VHF commercial FM frequencies just above the 2-meter ham band. 


Using your TNC in MODEM mode, with a PC and communications software, 
you can copy these broadcasts. The content of the broadcasts may be plain ASCII 
text (copyable with Pacterm - shipped with Kantronics TNCs) or graphics 
(copyable with “WeatherNode” software, carried by Kantronics). Interpretation 


User’s Guide 168 KPC-3 Plus v 8.2 


Other Modes of Operation Modes of Operation 


of the content of the products is up to the software. For updated information on 
EMWIN and software to copy its modes, search the Internet. 


To copy the broadcasts, simply cable together the equipment mentioned above, 
tune your VHF FM receiver to the local EMWIN frequency, set the KPC inter- 
face command to MODEM, and follow the text on your PC screen. 


Kantronics Host Mode Operation 


Kantronics’ Host Mode allows your TNC to communicate with computer soft- 
ware that is more sophisticated than standard terminal programs such as 
Pacterm. Software, such as Kantronics’ HostMaster II+, that supports this mode 
will automatically set your TNC INTFACE command to HOST mode and per- 
form a soft reset. 


Your host program will provide you with some means to give commands to the 
TNC. For a complete description of your host program, refer to the manual that 
comes with your software. 


+ After you switch to HOST mode, your TNC will remain in HOST mode until you 
switch to COMMAND mode. The easiest way to switch out of HOST mode is to 
use your host mode software (see instructions with that software). If you begin 
using Pacterm while the TNC is in HOST mode, you will see the message 
dlsagl ”, sent by the TNC to indicate that it is in HOST Mode. If you see this 
message, you must first exit the Host Mode before you can start talking to your 
unit with a program such as Pacterm. You must send three characters to the TNC 
in order to exit the Host Mode and go back to COMMAND mode. First, send a 
FEND character (ASCII code 192), then the letter q (upper or lower case is ok), 
and finally another FEND character. Your TNC will then leave Host Mode, 
switch to COMMAND mode, and send the usual Kantronics sign-on message. If 
you use a terminal program other than Pacterm, it may send these characters au- 
tomatically, or it may require that you carry out this same procedure to get out of 
HOST mode and to COMMAND mode. See Appendix D for details on this pro- 
cedure. 


KISS Mode 


Amateur packet radio communications can use the TCP/IP suite of protocals in- 
stead of AX.25 by switching to KISS mode and running software that supports 
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the KISS code designed by Phil Karn (see references at end of this section). The 
KISS protocol specifies the communication between a TNC and a host (e.g., 
computer). 


KISS Mode allows the TNC to act as a modem and packet assem- 
bler/disassembler (PAD). In KISS Mode, data-processing is shifted from the 
TNC to a computer running special software supporting the KISS code designed 
by Phil Karn. KISS code supports higher level protocols (i.e. TCP/IP) for sharing 
computer resources in a network fashion. Examples of TCP/IP programs are 
NET, NOS, and JNOS. Also, some networking software (G8BPQ) requires the 
KISS Mode of operation. 


Technical Note: In the KISS Mode, the TNC simply passes all received data to your 
computer, and the computer program is responsible for all processing of that data, 
including decisions concerning routing, digipeating, and other control decisions. 
The TNC converts the packets of synchronous data being received from the radio 
link into packets of asynchronous data to be passed to the computer over the serial 
port, and converts the packets of asynchronous data from your computer into the 
synchronous format suitable for radio transmission. The TNC retains the responsi- 
bility of determining proper timing for channel access. 


To place your TNC in KISS Mode, you must first have the command prompt 
(cmd:). Then type INTFACE KISS and press return. And, finally, do a RESET. 
After that you will not see any message or any prompt back from the TNC, it will 
now be in KISS mode. 


If you turn your unit off while it is it INTERFACE KISS mode, it will still be in 
KISS mode when you turn it back on. To get out of KISS mode, either: 


e perform a hard reset, or 


e use the TCP/IP command (available in KISS software while in KISS 
mode), or 


e send the CO FF CO sequence from your keyboard. 


To send the CO FF CO sequence from your keyboard (using a PC compatible 
computer): 
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1. Press and HOLD the ALT key. Type the numbers 192 from the numeric 
KEYPAD, not the keyboard. Release the ALT key. 


2. Press and HOLD the ALT key. Type the numbers 255 from the numeric 
KEYPAD, not the keyboard. Release the ALT key. 


3. Press and HOLD the ALT key. Type the numbers 192 from the numeric 
KEYPAD, not the keyboard. Release the ALT key. 


If the terminal program you are using sent all those characters, you will be out of 
the KISS Mode now. 


References on KISS Mode 


Karn, P.: “TCP/IP: A Proposal for Amateur Packet Radio Levels 3 and 4", 
pp. 4.62-4.68 ARRL Amateur Radio Computer Networking Conferences 1-4. 
Newington, CT: ARRL, 1985. 


Chepponis, M. and Karn, P.: “The KISS TNC: A Simple Host-to-TNC 
Communications Protocol”, pp. 38-42, 6th Computer Networking Conference, 
Newington, CT: ARRL, 1987. 


XKISS (Extended KISS) Mode 


The TNC also supports the G3BPQ multi-drop KISS Mode, called extended 
KISS (XKISS) . With this mode, the TNC can be connected to a G83BPQ node 
along with the other TNCs on the same serial port, to provide multiple radio ports 
to the node. Otherwise, XKISS works like KISS. For information on this mode of 
operation, see the documentation for the XKISS software you are using. 
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DAMA (Slave Mode) Capacity 


All of Kantronics’ current amateur TNCs (KAM Plus, KPC-3 Plus, and 
KPC-9612 Plus) support the DAMA protocol (slave mode) as used by many ama- 
teur radio operators in Germany, Belgium, Luxembourg, the Netherlands, France, 
Switzerland and other parts of Europe. 


Note: To the best of our knowledge there are no DAMA nodes in operation in the 
US or anywhere else outside of Europe. 


What is DAMA? 


DAMA (Demand Assigned Multiple Access) is a network protocol for regulating 
packet traffic to eliminate or dramatically reduce collisions among users on the 
crowded channels available to amateurs in densely-populated northern Europe. 
As the European channels have become more and more crowded and more and 
more DAMA systems have been established, it has become a necessity for TNCs 
to be equipped with the DAMA slave protocol in order to use the local networks. 
In the DAMA system, a “master” node is set up in each local area to control 
transmissions from all stations connected to the node. By local agreement, users 
do not connect directly to each other; they connect only through the master. 


+ DAMA was developed in Germany by NORD><LINK. (References to more in- 
formation on DAMA are provided in the bibliography at the end of this section.) 


What Does a DAMA System Look Like? 


The DAMA master node requires a computer running specialized DAMA soft- 
ware. TheNetNode (TNN) software, developed by NORD><LINK is one such 
specialized program which is used in the computer of a DAMA master along 
with one TNC, with a special EPROM for each radio frequency used on the sys- 
tem. RMNC/FlexNet software is another program which is very popular in Ger- 
many. 


Within each Local Area Network (LAN), end users set themselves up as DAMA 
“slaves,” using specially equipped TNCs which contain firmware (EPROM) that 
can operate ina DAMA “slave” mode (such as the Kantronics TNCs with 
DAMA slave mode support). The slaves may use a standard terminal or host 
mode program or any of a variety of specially written European programs, such 
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as SP, Grafik Packet and ESKAY, some of which make use of the KISS mode 
feature of the TNC. 


To use the DAMA system, the user connects to the DAMA master with a normal 
connect frame. When the master responds to the connect frame, the TNC is auto- 
matically placed into DAMA slave mode. The DAMA master polls each slave 
within the LAN in a “round-robin” fashion (somewhat like the token passing 
method) and the slave TNCs transmit packets when the master has granted per- 
mission to do so. The slave TNCs continue to be polled with priority among the 
slaves assigned according to the number of times each responds with information 
frames (as opposed to rr frames - i.e., no data to send). Priority is dynamically 
assigned so that those stations that are sending information are polled more fre- 
quently than idle stations. However, once an “idle” station responds with infor- 
mation, its priority is upgraded. 


Communication over the wider area is handled between the DAMA master nodes 
which are connected to each other using a standard NET/ROM™ type protocol. 
For the DAMA system to work effectively, each slave associates with only one 
master node and connects only to that master. If an end user is connected to 
more than one master, each master will poll the slave TNC according to its poll- 
ing schedule. When polled, the slave TNC will transmit a// frames it has avail- 
able to whichever master polls it. This would increase the probability of 
collisions with other users, thus defeating the purpose of the DAMA system. 


How is DAMA Implemented in Kantronics TNCs? 


Most Kantronics TNCs, including the KPC-3 Plus, KPC-9612 Plus, and the 
KAM Plus, implement the DAMA slave mode, using the following commands 
(see the Command Reference section for details): 


DAMA {ON|OFF} 


Set DAMA to ON to have your Kantronics TNC operate as a DAMA slave sta- 
tion once a connection is established with a DAMA master station. When 
DAMA is OFF, the TNC will operate in it’s carrier sense multiple access mode 
(CSMA). For details, see the CD, SLOT, and PERSIST commands in the Com- 
mand Reference section of this manual. 
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DAMACHCK n (n = 0 to 225) 


Set a “DAMA time-out” timer (in 10-second increments) to specify how long 
your TNC (running in DAMA slave mode) will wait to be polled by a connected 
DAMA station before disconnecting from the DAMA station and reverting to 
CSMA operation . 
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CAUTION! The DAMA firmware in Kantronics’ TNC is based on documentation published in the 
ARRL Computer Networking Conference papers (see Bibliography) and documentation provided 
by NORD><LINK, the developers of DAMA. This firmware was tested with TheNetNode firm- 
ware (Version 1.56), TFKISS (Version 2.0) and by volunteer testers in Europe with firmware used 
in existing DAMA networks. Kantronics cannot be responsible for subsequent changes to the 
DAMA protocol which may render this firmware obsolete nor guarantee satisfactory operations 


with newer versions of the protocol and/or complementary software. 
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Introduction 


This chapter documents all KPC-3 Plus commands. 


There are many commands which affect operation of the KPC-3 Plus. Some 
commands affect performance under specific conditions, some change parame- 
ters affecting general operation and others direct a one-time action. 


The user changes parameters and issues instructions to the KPC-3 Plus by typing 
commands composed of English-like word abbreviations and variables which are 
numbers or strings of characters chosen by the user. You will probably never 
change some of these parameters. 


Default values are stored in the EPROM. If you change any setting or value, the 
new setting or value will be stored in battery-backed RAM and will be the value 
used at future power-on. 


The availability of the commands listed here depends upon what INTFACE 
(i.e., INTERFACE) mode the KPC-3 Plus is currently in (see the INTFACE 
command in the command listing below and check the index for more informa- 
tion on INTFACE modes). 


Format for Listing Commands 


All KPC-3 Plus commands are listed alphabetically below. 


A “©” bullet in front of the name of a command indicates that the command is a 
NEWUSER Command — it will be available for use when the KPC-3 Plus is set 
to NEWUSER Mode. 


The KPC-3 Plus ships with NEWUSER as the default INTFACE mode. Also, the 
KPC-3 Plus will be in NEWUSER mode after a hard reset. 
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Format Defining Commands 


The Command Line 


The first line of each command definition shows the syntax for entering the com- 
mand, beginning with the name of the command, followed by a listing of any pa- 
rameters that may be used with the command. 


The full name of each command is shown in CAPS and a “short-form” of the 
command is shown by the underlined characters in the name. The short-form of 
the command is the shortest string of characters, starting from the beginning of 
the full name, that will allow the KPC-3 Plus to uniquely identify the command 
being requested. 


The KPC-3 Plus scans an internal list of commands — which is NOT in alphabeti- 
cal order — and selects the first match with the string you enter. 


The command name is followed by a space. 


After the space, there may be one or more parameters that need to be used, or that 
may optionally be used, with the command. 


e Values that need to be entered as they are shown (or by using the 
short-form indicated by the underlined character(s)) are shown in CAPS , 
as in “ON | OFF”. Parameter names for which a value needs to be 
substituted are shown in lower case letters, as in “callsign,” which means 
a particular callsign needs to be entered. 


e Lists of parameter values are enclosed in curly brackets “{ }” for 
grouping clarity and lists of optional parameter values are enclosed in 
square brackets “[ |’. 


e Ifmore than one choice is possible for the value of a given parameter 
(i.e., flag), choices are separated by a vertical bar, as in “ ON | OFF” or 
“OPTION]1 | OPTION2 | OPTION3". 


If a parameter can take a range of values (or in cases such as ABAUD, any of a 
set of numerical values) the parameter is shown as a name in lower case (e.g., 
“n’’) and the permissible range of values ( or the list of possible values) is given 
in parentheses “( )” to the right side of the command, after the syntax has been 
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presented. For example, possible values of the parameter “‘n” are defined as 
“(n= 1- 255)”. 


The Line Below the Command Definition 


If commands have parameters, default values are shown on the line below the 
command definition. 


Some KPC-3 Plus commands take effect immediately, so they are called “imme- 
diate” commands (e.g., K means “switch to CONVERSE mode"). This will be 
stated on the second line. For example, the command to go to CONVERS mode 
says “immediate” on the second line. 


More Information on Commands 
Each command is explained in detail and examples are given where appropriate. 


Following the explanation of the command, there may be a “See also” list that 
shows related commands. 


Parameter Types 


Almost all parameters are of one of the following types (exceptions are discussed 
when they are encountered in the command listing). 


n (range) 


Any number within the range is permissible. The unit of measure (seconds, ms, 
baud, count, etc.) for the number will be given in the description. These are deci- 
mal numbers. 


n ($00 - $FF) 


Special functions: Some parameters are used to control special functions, such as 
specifying the character to use to enter the Command mode from the Convers 
mode or specifying the character to use for “backslash”. Possible values and de- 
fault values for these parameters are shown in HEX format. 


The “digits” of a hex number represent powers of 16, analogous to the powers of 
10 represented by a decimal number. The decimal numbers 10 through 15 are 
represented in hex by the letters A through F (e.g., decimal 10 is hex A). Anda 
hex number is distinguished from a decimal number by preceding it with a “$” 
prefix. 
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For example: 


$1B = (1*16) + 11 = 27 


Number codes for these special characters are shown in hexadecimal (hex) form 
(i.e., base 16). They can be entered either in decimal or in hex. Permissible val- 
ues are shown in HEX: for example (n = $00 - $FF). 


Note: Setting a function character to zero ($00) disables that function. 


+ See the ASCII Chart at end of this manual for a listing of ASCH codes for all 
alphanumeric characters, including A to Z and 0 to 9, and conversions between 
hex and decimal representations. 


Several parameters are ASCII numerical values for characters which perform 
special functions. Most of these special function characters have “control charac- 
ters” as default values. Control characters are entered by holding down a special 
control key (normally marked “Ctrl’’) on the keyboard while typing the indicated 
key. For example, to enter a <Ctrl1+X>, hold down the Control key while typing 
an X, then release both keys. 


+ These special characters cannot be sent in a packet unless preceded by the pass 
character (see the PASS command) or unless you are operating in the Transparent 
Mode. 


Ifastreamswitch (STREAMSW) character or any other special character is defined 
as “$” then you will need to enter values in decimal, or precede the $ with the PASS 
character in order to enter hex numbers. 


flags ChoiceA|ChoiceB 


Many parameters are “flags”, meaning they have two possible values, ON and 
OFF, or YES and NO. All of the command descriptions show ON and OFF as the 
options; however YES (Y) and NO (N) may be typed instead. A few parameters 
are really flags, but rather than indicating that something is “on” or “off”, they 
select one of two ways of doing things. Some of these parameters have the values 
EVERY or AFTER indicating operating modes for data transmission. 
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The possible choices are separated by a vertical bar. Some of the flag parameters 
will allow many choices, such as ON|OFF|TO|FROM. 


callsigns xxxxxx-n 


Several commands require callsigns as parameters. While these parameters are 
normally Amateur callsigns, they may actually be any collection of numbers 
and/or letters up to six characters; they are used to identify stations sending and 
receiving packets. A callsign may additionally include an “extension” (SSID, 
Secondary Station Identifier), which is a decimal number from 0 to 15 used to 
distinguish two or more stations on the air with the same Amateur call (such as a 
base station and a repeater). The callsign and extension are entered and displayed 
as call-ext, e.g. NOGRG-3. If the extension is not entered, it is set to -0, and ex- 
tensions of -0 are not displayed by the KPC-3 Plus. 


text 


There are some commands which have a parameter text string. This string can be 
any combination of letters, numbers, punctuations, or spaces up to 128 charac- 
ters. In order to be used, all string parameters must contain at least one non-space 
character. You can even put characters with special meanings, such as carriage re- 
turn, into the string by preceding them with the PASS character. The string ends 
when you type a (non-passed) carriage return. 


Entering Commands 
To enter a command, the KPC-3 Plus needs to be in COMMAND Communica- 
tion Mode (as opposed to CONVERS or TRANS communication mode). 
The prompt for Command Mode is: 
cmd: 


+ Hint: Once you go into Packet Convers Mode a <Ctrl+C> (see COM- 
MAND) needs to be entered to return you to the Command Mode. In the 
Packet Transparent Mode or GPS Mode, a special sequence is needed to 
return to Command Mode (see CMDTIME). 
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+ Hint: If packets have been printing on the screen you may have forgotten 
which mode you are in. If you wish to see the cmd: prompt type a 
<Ctrl+C>, to see if you are already in Command Mode. If the prompt 
does not appear then you are either in Command Mode or in Transparent 
Mode. If you are in Command Mode, typing a Return will generate the 
“cmd:” prompt. If you are in Transparent Mode, you will not get the 
“cmd:” prompt when you press the Return key; instead, you need to enter 
three <Ctrl+C>s in rapid succession to switch to the Command Mode 
and get the “cmd:” prompt. 


When you are at the Command Mode prompt, you enter a command for the 
KPC-3 Plus by typing the command name (in upper or lower case) and any re- 
quired and optional parameter values (argument settings or values). 


+ The command name and each parameter value must be separated from each other 
by at least one space. 


To ENTER the command press the carriage return “CR” (usually an ENTER 
key). As soon as the “CR” key is pressed, the KPC-3 Plus will process the com- 
mand request and take whatever action is specified (or inform you with an “EH?” 
if it does not understand what you have entered). 


As noted above, you can enter the short-form of a command name — the charac- 
ters underlined in the listing. 


The short form is not necessarily the shortest unique string in the name or the first 
match in alphabetical order — rather it is the first match that the KPC-3 Plus will 


find as it scans through the non-alphabetical listing of commands in its EPROM. 


+ Hint: You can examine the value of any parameter by typing the command name 
followed by a “CR”. A special command, DISPLAY, allows you to see the values 
of all parameters or groups of related parameters. 
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KPC-3 Plus Commands 


All KPC-3 Plus commands are documented below, in alphabetical order. The un- 
derlined characters in a command’s name show the short-cut version of the com- 
mand. Required or optional parameters are shown after the command name, as 
are allowable ranges of values, where appropriate. 


8 


W 


TCONV {ON | OFF} 


default ON 


+ This command was added to the first TNCs built (1980s) to accommodate termi- 
nals that would not receive (or would be confused by) 8-bit characters, only 7-bit 
ASCII. We’ve retained the command today just in case you’re using such a ter- 
minal or computer. Also, it might be that your computer is capable of handling 
8-bit characters but your communications terminal program will reject (or be 
confused or “hung”’) by them. In these cases, you’ll need to set S3BITCONV OFF. 


When ON, transmission of 8-bit data is allowed in the packet Convers Mode and 
Transparent Mode. If you wish to obtain 8-bit data transmission but do not want 
all the features of Transparent Mode, set this command to ON. If OFF, the 8th 
data bit is stripped (set to 0) for transmission and all data received will have the 
8th bit set to 0. This does not affect the KA-Node, digipeat or PBBS functions. 


ABAUD n (n = 0,1200,2400, 4800, 9600,19200) 


default 0 


The parameter n sets the baud rate used for input and output through the serial 
RS232 port of the KPC-3 Plus to the computer. If 0 is used, the KPC-3 Plus will 
run an autobaud routine upon power-up. This routine looks for an asterisk (*) 
character from the attached computer to set the ABAUD parameter. 


If you wish to use a different baud rate, or to perform autobaud the next time the 
unit is powered up, you must change the ABAUD parameter. If you change the 
baud rate in your computer or terminal you should change the baud rate in the 
KPC-3 Plus first, then issue the RESET command, then set the new baud rate on 
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your computer. Otherwise a hard reset will be required to erase the ABAUD set- 
ting and reinitialize the KPC-3 Plus to perform the autobaud routine. (See Hard 
Reset section.) Note also that a hard reset will erase ALL stored parameters in 
your KPC-3 Plus and return them to factory defaults. 


See also: reset, restore 


ANALOG 


immediate 


Entering the ANALOG command returns a string of 8 values, based on the cur- 
rent voltage readings from 8 A-to-D lines. Only the first two of these values are 
relevant to the user, reporting two external voltages. 


At any given time, each of the 8 A-to-D lines will have a voltage value some- 
where in the range of 0-5 VDC. Instead of reporting voltages, the ANALOG 
command returns a decimal number in the range of 0 - 255 for each line. Each 
decimal value corresponds to a voltage input. 


The reason ANALOG returns 8 values is that it is attached to an 8-way mux input of 
a single A/D converter. In the KPC-3 Plus, only the first two values are relevant to 
the user (several other lines could be used for special purposes, with appropriate 
modifications of the board, but they are normally intended just for internal use 
within the KPC-3 Plus). 


The response is in the following form: 
ANO/AN1I/AN2/AN3/AN4/ANS5/AN6/AN7 


e ANDO, input (0), reports a decimal number in the range of (0-255), 
representing the current DC voltage of an external input read from 
either pin 4 on the Radio Port or from pin 18 on the Serial Port, 
depending on the current setting of jumper J8: 


¢ Ifjumper J8 is in position 1, the external voltage input is read from 
pin 4 of the Radio Port. 


¢ Ifjumper J8 is in position 2, the external voltage input is read from 
pin 18 of the Serial Port. 
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Note: As shipped, jumper J8 is off to the side, so it is not in either position 1 
or position 2. If J8 is in neither position | nor position 2, ANO will not re- 
port meaningful values. 


e ANI, input (1), reports a decimal number in the range of (0-255), 
representing the current DC voltage of external input read from either 
pin 8 on the Radio Port or from pin 11 on the Serial Port, depending on 
the current setting of jumper J10: 


e Ifjumper J10 is in position 1, the external voltage input is read from 
pin 8 of the Radio Port. 


e Ifjumper J10 is in position 2, the external voltage input is read from 
pin 11 of the Serial Port. 


Note: As shipped, jumper J10 is off to the side, so it is not in either position 
1 or position 2. If J10 is in neither position 1 nor position 2, AN1 will not 
report meaningful values. 


e ©AN2, is not used in the KPC-3 Plus. 

e =©6AN3, is not used in the KPC-3 Plus. 

e =AN4, input (4), is intended for internal use. 

e =©ANS, is not used in the KPC-3. 

e AN6, input (6), is intended for internal use. It reports the current status 


of the RTS pin for the serial port, which is either 0 (or near 0) for logic 
low or 255 (or near 255) for logic high. 


e AN7, input (7), is intended for internal use. It reports the current status 
of the DTR pin for the serial port, which is either 0 (or near 0) for logic 
low or 255 (or near 255) for logic high. 


+ Data can be gathered from a remote site by connecting to MYREMOTE and then 
issuing the ANALOG command. 


See also: myremote 
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AUTOLF {ON | OFF} 


default ON 


When ON, a line feed is sent to the terminal after each carriage return. This pa- 
rameter should be set on when overprinting occurs and the terminal being used 
does not automatically supply its own linefeed after a carriage return. This com- 
mand affects only the data sent to the terminal, not data sent to the radio. 


See also: cr, lfadd 


AX2512V2 {ON | OFF} 


default ON 


This command provides compatibility with all known packet units implementing 
AX.25 protocol. When ON, Level 2 Version 2 protocol is implemented and the 
TNC will automatically adapt to whichever version the connecting station is us- 
ing. When OFF, Level 2 Version | is implemented. Set this command to OFF if 
you need to digipeat through other units which do not digipeat version 2 packets. 
You may also find benefit from setting this command OFF when using several 
digipeaters (not nodes) to send packets, or when conditions are marginal between 
the two stations involved. (NOTE: Changing this setting after connecting to an- 
other station will have no effect on the current connection.) 


The major difference in V1 and V2 protocol is the method used to handle retries. 
In the connected mode, if a packet is sent and not acknowledged, Version 1 will 
re-send the entire packet and then disconnect if the RETRY count is reached. 
Version 2 will first send a poll, the response to this poll will determine if the 
packet was received. It is possible that the ack was collided with and therefore 
the data packet does not need to be resent. If the ACK shows that the data packet 
was not received, it will be re-transmitted. Each time a poll is answered the 
TRIES count is reset to 0. If the RETRY count is reached, version 2 will attempt 
to re-connect 
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unless RELINK is OFF. If the re-connect attempt is unsuccessful, then version 2 
will issue a disconnect. 


See also: relink, retry, tries 


For more information, see the book 4X.25 Amateur Packet-Radio Link-Layer 
Protocol Version 2.0 October 1984, which can be obtained from the ARRL. 


AXDELAY n (n = 0 - 255) 


default 0 


The value of “n’ is the number of 10 millisecond intervals to wait, in addition to 
TXDELAY, after keying the transmitter before data is sent. This delay can be 
helpful when operating packet through a standard “voice” repeater, or when us- 
ing an external linear amplifier which requires extra key-up time. Repeaters using 
slow mechanical relays, split-sites, or both require some amount of time to get 
RF on the air. 


See also: axhang 


default 0 


Each increment specifies 10 millisecond intervals. This value may be used to im- 
prove channel utilization when audio repeaters with a hang time greater than 10 
msec are used. If the repeater squelch tail is long, it is not necessary to wait for 
AXDELAY after keying the transmitter if the repeater is still transmitting. If the 
TNC has heard a packet within the AXHANG period, it will not add AXDELAY 
to the key-up time. 


See also: axdelay 
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BEACON [EVERY | AFTER] n (n = 0 - 255) 


default Every 0 


The value entered for “n” is the number of minutes (i.e., one-minute intervals) to 
use with the beacon command. 


A value of 0 turns the beacon OFF. Setting a value greater than 0 activates the 
beacon under the conditions specified. If the optional keyword Every is used, a 
beacon packet will be sent every n minutes. If set to After, a beacon packet will 
be sent ONCE after the specified interval with no channel activity. 


The beacon frame consists of the text specified by BTEXT in a packet addressed 
to “BEACON”. Beacon messages will be digipeated via any addresses specified 
in the UNPROTO command. 


See also: btext 


\e) 


BKONDEL {ON | OFF} 


default ON 


When ON, the sequence backspace-space-backspace is sent to the attached termi- 
nal when the DELETE character is entered. When OFF, the backslash character 
“\’? ig sent to the terminal when the DELETE character is entered. 


See also: delete, redisplay 


BLT n {EVERY | AFTER} hh:mm:ss [START hh:mm:ss] 
(n = 1 - 4) 


default EVERY 00:00:00 (for each of the 4 LT strings) 


This command (used with GPS) sets the interval between beacons for the 
associated LT (Location Text) string. 


n identifies which LT is used (1-4). If EVERY is specified, the LT will be trans- 
mitted at the interval specified by the hh:mm:ss parameter. This is set in 
hours:minutes:seconds, and all characters must be specified. If the optional key 


User’s Guide 188 KPC-3 Plus v 8.2 


KPC-3 Plus Commands Command Reference 


word START is given followed by a time (in 24 hour format), the beacons will 
not be transmitted until the specified time. The beacon will then be transmitted 
according to the setting of the EVERY parameter. (NOTE: If the current time is 
past the start time, the beacon will start at the next scheduled interval based on 
the start time.) 


If AFTER is specified, the beacon will be transmitted once after no activity is de- 
tected on the channel for hh:mm:ss time. Selecting AFTER does not allow the 
optional START parameter. 


For example, setting BLT 3 EVERY 00:15:00 START 03:30:00 would cause the 
third LT string (LT 3) to be transmitted every 15 minutes, with the first transmis- 
sion each day occurring at 03:30:00. 


BREAK {ON | OFF} 


default OFF 


If BREAK is ON, a break at the keyboard causes a return to Command Mode 
from Converse or Transparent Mode. 


See also: COMMAND 


BTEXT text (0 - 128 characters) 


default (blank) 


BTEXT specifies the content of the data portion of the beacon packet. Any com- 
bination of characters and spaces may be used with a maximum length of 128. 
Entering a single “%” will clear BTEXT. 


See also: beacon 
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BUDLIST [ON|OFF] [NONE | {+|-}call | calll,call2,...] 
where call={callsign | {<|>}callsign | 
callsign{>|<>}callsign} 


default OFF NONE 


BUDLIST is used to determine which received packets will be monitored. When 
OFF or NONE, BUDLIST will allow monitoring of all packets, even if it has 
callsigns in it’s list. 


The maximum number of callsigns allowed in BUDLIST is 10. Up to 10 
callsigns may be entered at once, using the format shown after the command 
name, and the new list of from 1 to 10 callsigns will replace whatever list was 
there before. The BUDLIST command can be used to add a single callsign 
(+callsign), so long as there is room for the new callsign on the list (if there is 
not, the TNC responds with “EH?” and returns you to the command prompt). 
Similarly, you can remove a single callsign (-callsign) from the list. And to re- 
move all items from the current list, enter BUDLIST NONE. 


A callsign entered without a SSID will match any SSID of that callsign. To match 
a specific SSID only, enter the callsign with that SSID: for example, callsign-n, 
where n = 0-15. 


More selective monitoring is enabled when a callsign or two callsigns is com- 
bined with a “>” and/or a “<” character. For example, entering “>callsign” will 
enable monitoring of packets TO that callsign (assuming BUDLIST is ON), en- 
tering “<callsign” will enable monitoring of packets from the callsign, entering 
“callsign1>callsign2" will enable monitoring of packets from callsign! to 
callsign2, and entering ”callsign!<>callsign2" will enable monitoring of packets 
from callsign! to callsign2 and vice versa. 


+ Note that entering callsign1>callsign2 or callsignl<>callsign2 counts as two of 
the 10 maximum allowed callsigns. 
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ALTBRAT 


immediate 


The CALIBRATE command generates a signal which may be used as an aid in 
adjusting the audio drive level of the modem connected to your transceiver. 


The use of this command is explained in the Calibration/Equalization Section. 


See also: Calibration/Equalization section 


CANLINE n (n = $00 - SFF) 


default $18 <Ctrl+x> 


This command is used to change the cancel-line input editing command charac- 
ter. When in Convers or Command Mode entering a <Ctrl+X> will cancel all 
characters input from the keyboard back to the last un-PASSed carriage return 
(unless PACTIME has expired, CPACTIME is turned on, and you are in Convers 
Mode). 


See also: canpac, cpactime, pass 


CANPAC n (n = $00 - SFF) 


default $19 <Ctrl+Y> 


This command is used to change the cancel-packet command character. When in 
the Convers Mode entering a <Ctrl+ Y> will cancel all keyboard input back to the 
last unpassed SENDPAC character (unless PACTIME has expired and 
CPACTIME is turned on). 


This character also functions as a cancel-output character in Command Mode. 
Typing the cancel-output character a second time re-enables normal output. For 
example, if you’ve told the TNC to do a DISPLAY, a <Ctrl+Y> will cancel the 
display and a second one re-enables the cmd: prompt after the next “CR”. 


See also: canline, cpactime, sendpac 
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CD {INTERNAL | EXTERNAL | SOFTWARE} 


default INTERNAL 
The CD command selects which carrier detect method will be used. 


When set to INTERNAL, the TNC will detect a signal present on the channel, 
using an energy type carrier detect, allowing shared voice and data on the same 
channel. 


When set to EXTERNAL, the carrier detect is supplied by an external device, 
connected to the XCD pin on the radio port. 


If set to SOFTWARE, the firmware inside the TNC will detect the presence of 
data to enable the carrier detection, allowing operation with un-squelched audio. 
Correct operation of SOFTWARE carrier detect is affected by proper equaliza- 
tion and the SWP parameter. If your RCV light flickers, this is an indication that 
you may need to adjust the equalization. (Equalization is set with an internal 
jumper.) 


When CD is set to INTERNAL or SOFTWARE, the external carrier detect pin on 
the radio connector (if wired) is used to hold off the TNC from keying the radio. 


+ Hint: For one use of this function, see the APRS and GPS section of this manual. 


See also: swp 


CHECK n (n = 0 - 255) 


default 0 


This “timeout” command is used to prevent a “hang-up” in a connected mode 
when a link failure occurs as a result of conditions beyond control of the con- 
nected stations. The value entered for “n” is the number of 10 second intervals to 
wait during “no activity” before making a periodic check (poll) to determine that 
a connected state still exists. 


If n equals 0, this “timeout” function is disabled. While using Version 1 
(AX25L2V2 OFF), a check timeout will initiate a disconnect. 


See also: ax2512v2, kntimer, relink, rnrtime 
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CMDTIME n (n = 0 - 15) 


default 1 


This command sets the time allowed for entry of required characters to exit the 
Transparent Mode. In order to allow exit to Command Mode from Transparent 
Mode, while permitting any character to be sent as data, a guard time of 
CMDTIME seconds is set up. 


Entering a value for “n” sets the value of CMDTIME to “n seconds”. 


To exit Transparent mode, you need to wait at least CMDTIME since the last 
data character was sent to the KPC-3 Plus. Then you need to enter the COM- 
MAND character (e.g., <Ctrl+C>)) three times, with a wait of LESS THAN the 
value of CMDTIME between the first and second time you enter the COM- 
MAND character and also a wait of LESS THAN the value of CMDTIME be- 
tween the second and third time you enter the COMMAND character. 


After a final delay of CMDTIME the TNC will exit Transparent Mode and enter 
Command Mode. At this time you should see the cmd: prompt. If CMDTIME is 
set to zero, the only exit from Transparent Mode is a modem break signal, assum- 
ing BREAK is set to ON. 


For example (if CMDTIME is | second and COMMAND is <Ctrl+C>): wait one 
second, type a <Ctrl+C>, within one second type a second <Ctrl+C>, within one 
second type a third <Ctrl+C>, WAIT one second, cmd: prompt should appear. If 
your computer/program has the capability you can also send a modem break to 
escape Transparent Mode. 


See also: command, trans, break 


CMSG {ON | OFF | DISC | PBBS} 


default OFF 


When OFF, the custom connect text stored in CTEXT will not be sent to the con- 
necting station upon receiving a connect request. When ON, the custom CTEXT 
string will be sent. When CMSG is set to DISC, the custom CTEXT string will 
be sent to the connecting station, and then your TNC will disconnect from that 
station. If set to PBBS, the custom CTEXT string will be sent to the connecting 
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station, and then the connection will automatically be transferred to your PBBS. 
If the PBBS is not available, your TNC will disconnect from the station. 


See also: ctext, pbbs 


COMMAND n (n = $00 - SFF) 


default $03 <Ctrl+C> 


This command is used to change the Command Mode entry character. When 
COMMAND is set to the default value, typing a <Ctrl+C> causes the TNC to re- 
turn to Command Mode from packet Convers Mode. See CMDTIME for return- 
ing to Command Mode from Transparent Mode. 


@) 
iO 
Zi 
Ee 


Ist [ON | OFF] [NONE | {+|-}callsign | 
callsignl,callsign2...] 


default OFF 


CONLIST is used to determine which stations (callsigns) may use your station 
for ANY purpose, including digipeating.. When ON, the TNC will recognize 
only those packets received with a callsign that appears in the CONLIST’s list of 
callsigns; and you will not be able to connect to any station that is not in the 
conlist. When OFF, the TNC will process all packets. 


The maximum number of callsigns allowed in CONLIST is 10. Up to 10 
callsigns may be entered at once, using the format shown after the command 
name, and the new list of from 1 to 10 callsigns will replace whatever list was 
there before. The CONLIST command can be used to add a single 

callsign (+callsign), so long as there is room for the new callsign on the list 

(if there is not, the TNC responds with “EH?” and returns you to the command 
prompt). Similarly, you can remove a single callsign (-callsign) from the list. 
And to remove all items from the current list, enter CONLIST NONE. 


A callsign entered without a SSID will match any SSID of that callsign. To match 
a specific SSID only, enter the callsign with that SSID: for example, callsign-n, 
where n = 0-15. 


User’s Guide 194 KPC-3 Plus v 8.2 


KPC-3 Plus Commands Command Reference 


CONMODE {CONVERS | TRANS} 


default CONVERS 


This command controls the mode the TNC will be placed in AUTOMATICALLY 
after a connect if NOMODE is OFF. The connect may result either from a con- 
nect request received or a connect request originated by a CONNECT command. 
If the TNC is already in Convers or Transparent Mode when the connection is 
completed, the mode will not be changed. If you have typed part of a command 
line when the connection is completed, the mode change will not take place until 
you complete the command or cancel the line input. 


See also: canline, connect, convers, nomode, trans 


O CONNECT calll [VIA call2,call13,...,call19] 


immediate 
calll = callsign of station to be connected to. 


call2,...,call9 = optional stations to be digipeated through. A maximum of 8 
digipeater addresses (callsigns or aliases) can be specified. This is referred to as a 
path. 


Each callsign may also have an optional Secondary Station Identifier (SSID) 
specified as -n, where n = 1 - 15. The digipeat callsigns are specified in the order 
in which they are to relay transmitted packets. The mode set by CONMODE will 
be entered upon successful connect, if NOMODE is OFF. If no response to the 
Connect request occurs after RETRY attempts, the command is aborted. A time- 
out message is printed on the display and the TNC remains in the Command 
Mode. The station being connected to (calll) may receive the connect request but 
be unable to accept connects, in which case a busy message will be printed to the 
screen and the TNC will stay in Command Mode. Connect requests may only be 
initiated in the Command Mode and the connect will be established on the cur- 
rent stream. 
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If a connect is in progress, or already established, the path may be changed by 
simply re-issuing the CONNECT command with the desired path. This must be 
done on the same stream as the original connect. 


CAUTION, packets en route between your station and the reconnected station may 
be lost. 


If CONNECT is entered with no parameters, the status of the current stream is 
displayed. 


See also: conmode, conok, dbldisc, maxusers, nomode, retry, ring, streamsw, xmitok 


CONOK {ON | OFF} 


default ON 


When ON, connect requests from other TNCs will be automatically acknowl- 
edged and a <UA> packet will be sent. The standard connect message, with 
stream ID if appropriate, will be output to the terminal and the mode specified by 
CONMODE will be entered on the I/O stream if you are not connected to another 
station and NOMODE is OFF. 


When OFF, connect requests from other TNCs will not be acknowledged and a 
<DM> packet will be sent to the requesting station. The message “connect re- 
quest: (callsign of whoever is trying to connect to you)” will be output to your 
terminal if INTFACE is TERMINAL or NEWUSER. 


When CONOK is OFF, you can still connect to your mailbox. 


When operating with multiple connects allowed, the connection will take place 
on the next available stream. Connect requests in excess of the number allowed 
by the USERS command will receive a <DM> response and the “connect re- 
quest: (call)” message will be output to your terminal if INTFACE is TERMI- 
NAL or NEWUSER. 


See also: conmode, connect, intface, maxusers, monitor, nomode, users 
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CONPERM {ON | OFF} 


Default OFF 


Setting CONPERM to ON forces the connection on the current stream to become 
permanent and causes the KPC-3 Plus to attempt to reconnect when it is re- 
started. 


CONPERMED connections are shown with /P in the status display, which is gen- 
erated by the STAT command. 


See also: status 


O CONVERS 


immediate 


CONVERS has no options. It is an immediate command and will cause entry into 
Conversational Mode from Command Mode on the current I/O stream. Any link 
connections are not affected. 


+ Hint: K is the same as CONVERS, for quicker entry. 


See also: k, command 


PACTIME {ON | OFF} 


default OFF 


When OFF and in the Convers Mode, packets are sent when the SENDPAC char- 
acter is entered or when PACLEN is achieved. When ON and in the Convers 
Mode, packets are sent at periodic intervals determined by PACTIME. Characters 
are sent periodically as in Transparent Mode but the local editing and echoing 
features of Convers Mode are enabled. 


See also: convers, cr, paclen, pactime, sendpac, trans 
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CR {ON Jl “QEEY 


default ON 


When ON the SENDPAC character (normally carriage return) is appended to all 
packets sent in Convers Mode except when PACLEN is exceeded. Setting CR 
ON and SENDPAC $0D results in a natural conversation mode. Each line is sent 
when a “CR” is entered and arrives at its destination with the “CR” appended to 
the end of the line. To avoid overprinting, AUTOLF may need to be ON at the re- 
ceiving end. 


See also: autolf, lfadd, sendpac 


CRSUP {ON | OFF} 


default OFF 


This command was added to the first multi-mode TNCs (such as the Kantronics 
UTU and KAM) to accommodate the practice by radio teletype (RTTY) opera- 
tors of adding an extra carriage return (CR) at the end of each line (i.e., CR, CR, 
linefeed (LF) ). This was done to give the carriage of the old mechanical tele- 
types time to return across the page. Some of these machines are still in use, so 
we’ ve retained this command so you can “correct” the data you might receive 
from such a station. To do so, turn CRSUP ON. When ON, this command sup- 
presses every other carriage return (when no data is between them) in the re- 
ceived data before sending the data to the terminal. When CRSUP is OFF, all 
carriage return characters are left in the received data as it is sent to the terminal. 


See also: autolf, lfsup 


STAMP {ON | OFF} 


default OFF 


When ON, the daytime stamp is printed with all “*** CONNECTED TO” and 
“ea T)TSCONNECTED” messages on the terminal. 


See also: connect, daytime, disconnect, mstamp 
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(G 
HK 


EXT text (0 - 128 characters) 


default (blank) 


Enter any combination of characters and spaces up to maximum length of 128. 
Entering a single “%” will clear CTEXT. This entry specifies the text of the first 
packet to be sent in response to an accepted connect request provided that the pa- 
rameter CMSG is not OFF. 


See also: cmsg, connect 


CTRL [A | B] {n | ON | OFF | LONG} (n=1-20) 


immediate 


This command causes the KPC-3 Plus to activate the specified output line (A or 
B) to the radio port as indicated. If A or B output is not specified, both outputs 
are affected. For instance, to pulse the A output (CTLA) 3 times, you would give 
the command “CTRL A 3". You may optionally specify the number of times to 
pulse the output (n), or to turn the output ON, or OFF. Each pulse on the output 
line lasts approximately 100 milliseconds (0.1 seconds). Specifying LONG re- 
sults in one pulse of the output line, lasting approximately 1.5 seconds. These are 
open drain outputs and are pulled to ground when active. For more information, 
see the section on “Connecting to your Radio” in this manual. 


Do not allow more than 200mA of current in this circuit. 


CWID [EVERY | AFTER] n (n = 0 - 255) 


default EVERY 0 


Each increment specifies | minute intervals. A value of 0 turns the ID OFF. Set- 
ting a value greater than 0 activates the ID under the conditions specified. If the 
optional keyword Every is used, an ID will be sent every n minutes. If set to Af- 
ter, an ID will be sent ONCE after the specified interval with no channel activity. 
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The string specified by the CWIDTEXT command will be sent in Morse Code, 
using AFSK tones. 


Some countries require all stations to ID in Morse code periodically. 


See also: mycall, cwidtext 


CWIDTEXT text (0-15 characters) 


default DE mycall 


This command sets the text to be transmitted when the KPC-3 Plus performs an 
automatic CWID. The text will be transmitted periodically as set by the CWID 
command. 


See also: cwid 


DAMA {ON | OFF} 


default OFF 


When ON the TNC can operate as a DAMA slave station once connection is es- 
tablished with a DAMA master station. When OFF the TNC operates in standard 
Packet mode (i.e., CSMA — Carrier Sense Multiple Access). 


See also: damachck 


DAMACHCK n (n = 0 to 255) 


default 18 


This command sets a DAMA timeout timer in 10-second increments. If the TNC 
is connected to a DAMA master station (that is, operating in DAMA slave mode) 
and the master does not poll the TNC for data before the DAMACHCK timer ex- 
pires, the TNC will revert to CSMA operation and disconnect from the DAMA 
master. 
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This command was added to allow the user to regain CSMA connect capability in 
the event the DAMA master fails to poll because of a node failure - lightning 
strike, power outage, etc. 


See also: dama 


DAYSTR text (see format below) 


default mm/dd/yy hh:mm:ss 


The DAYSTR command is used to set the FORMAT of your date/time display. 
DO NOT enter an actual date or time, simply enter the form of the display you 
would like, using the lower case letters m, d, h, y, and s as described below. 


The format you enter is used for all time stamps, including the PBBS, KA-Node, 
Mheard list, etc. 


The lower case characters m, d, y, h, and s have special meaning to this command 
and will be replaced with data from the software clock. The lower case m will be 
replaced with the minutes the first time it appears after a lower case h. If h, m, y, 
d, or s is specified as a single character, the corresponding date/time element will 
be displayed as a single digit if the value is less than 10. Entering two characters 
will force a two digit display for values under 10. If the month is entered as three 
ms, it will be displayed as the first three characters of the month name (JUL). 
You may also enter any other text you wish, allowing you to add such things as 
your time zone. 


+ Remember ALL lower case m, d, y, h, and s will be replaced by actual values. 


Some examples of setting the DAYSTR command and the resulting time/date 


display are: 
DAYSTR in Displ D Tim 
mm/dd/yy hh:mm:ss 07/16/93 12:14:22 
d.m.y h:mm:ss 263. 73.93) L2s7 422 
d.mm.yy h:mm 16.07.93 12:14 
mmm d 19yy h:mm CST JUL 7 1993 12:14 CST 


TIME hh:mm DATE: mmm dd, 19yy TIME 12:14 DATE JUL 07, 1993 
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+ This command is used to define how date and time are to be displayed; it is not 
used to enter an actual date and time (which you do by using DAYTIME). If you 
enter an actual date and time with the DAYSTR command, your clock will ap- 
pear to stop. 


See also: daytime 


O DAYTIME yymmddhhmm [ss] 


DAYTIME is used to enter a date and time (after which time and date are format- 
ted for display by the specifications given in DAYSTR). 


When date and time are entered, using the input format specified in the command 
and explained below, the values entered are used to set the software clock/calen- 
dar. The software clock/calendar is then used for MHEARD and NDHEARD log- 
ging, as well as for CSTAMP and MSTAMP functions. 


When entering the daytime digits, enter them in pure number sequence with no 
spaces, dashes, or slashes. Notice that there are two digits each for entering a 
year, month, day, hour, minute, and (optionally) second. Also, notice that you 
need to use the order given here, which has nothing to do with the format (given 
in DATSTR) for displaying date and time values. For example, to enter 1986, 
January 2, at 22:30:00 hours, the value of the DAYTIME parameter would be 
860102223000. In this case, seconds were entered, so the string is 12 characters 
long (2 characters for each of six pieces of information entered). 


If DAYTIME is entered with no parameter, the daytime is displayed using the 
format defined by the DAYSTR command. 


+ Hint: If the time appears to be stuck, check the current value of DAYSTR, to be 
sure that the DAYSTR setting is being used to format the display of time and 
date, and not (in error) to attempt to supply an actual date and time. If this is not 
the case, fix the problem and see if time and date displays work correctly. 


See also: cstamp, daytweak, daystr, mheard, mstamp 
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DAY TWEAK n (n = 0 - 15) 


default 8 


This parameter is used to adjust the software clock, if needed, for accurate time 
keeping. Increasing the parameter will slow the clock, decreasing the parameter 
will speed up the clock. Each count corresponds to .64 seconds increase or de- 
crease per 24 hours. Ambient temperature will affect the clock to some degree. 


DAYTWEAK has no effect on the (optional) battery-backed clock (BBC); that 
clock is set only by using the DAYTIME command. The software clock stops when 
a soft reset or powering off occurs, and upon power on the software clock is set to 
the value of the BBC, if installed. 


See also: wefax 


DBLDISC {ON | OFF} 


default OFF 


When OFF, only one disconnect command (D) need be given to terminate an un- 
successful connect attempt. If you are actually connected, the normal disconnect 
sequence will occur. 


When ON, a normal disconnect sequence will always occur (you will not be dis- 
connected until you receive an acknowledge of your disconnect or until the retry 
count is exceeded). A second D is required to force a local disconnect independ- 
ent of the retry counter. 


See also: disconnect 
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\e) 


DELETE n (n = SOO - SFF) 


default $08 <Ctrl+H> 


This command sets the character to be used as the delete character. When this 
character is typed, the last input character is deleted. The most common settings 
are $08 (backspace) and $7F (delete). 


See also: bkondel 


DIGI PEAT {ON | OFF} 


default ON 


When ON, any packet received that has MYCALL, MYALIAS, or MYNODE 

(if KA-Node is active) in the digipeat list of its address field will be 
retransmitted. Each station included in the digipeat list relays the packet in the or- 
der specified in the address field. Digipeating takes place concurrently with other 
TNC operations and does not interfere with normal connected operation of the 
station. To disable digipeat operations (via MYCALL, MYALIAS, or MYNODE) 
turn this command OFF. 


See also: hid, myalias, mycall, mynode 


DISCONNE [MYPBBS | MYNODE x ] (x=KA-Node) 


immediate 


When given without options, “disconn ect” will initiate an immediate disconnect 
request on the current I/O stream. A successful disconnect results in the display 
of “*** DISCONNECTED”. If the RETRY count is exceeded while waiting for 
the connected station to acknowledge, the TNC moves to the disconnected state 
on that stream. Entering a second Disconnect command before RETRY has ex- 
pired will result in an immediate disconnect on your end, but may leave the other 
station thinking it is still connected to you. Disconnect messages are not dis- 
played when the TNC is in Transparent Mode. Other commands may be entered 
while the disconnect is in progress. 
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DISCONNE MYPBBS 


Issue this command if you want to cause the personal mailbox to issue a discon- 
nect to the user of the mailbox. D MYPBBS is what you should type, do not type 
the call entered in the mypbbs command. 


DISCONNE MYNODEx (x= KA-Node circuit) 


x may be any of the KA-Node circuits in use, designated by A, B, C, etc. This 
command will cause the node to disconnect the stations linked through the node 
on the circuit specified. MYNODE does not refer to the call entered in the 
mynode command, but is the actual characters to type. 


See also: dbldisc, newmode, retry, status 


O DISPLAY [c] 


immediate 


This command causes the TNC to display a list of all the parameters in the TNC. 
You may also display only a selected group of parameters by specifying the ap- 
propriate class identifier for that group. When using the DISPLAY command 
with a subclass be sure to use a space between the DISPLAY command and the 
subclass. Subclasses of related parameters are: 


ASYNC asynchronous port parameters 
(TNC to computer) 

CHAR special TNC characters 

GPS parameters related to GPS operations 

ID ID parameters 

LINK parameters affecting packet link 
(TNC to TNC) 

MONITOR monitor parameters 

PBBS mailbox commands 

TIMING timing parameters 


Individual parameter values can be displayed by entering DISPLAY and the com- 
mand name, followed by “CR”. 


See also: Display Listings section 
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O DWAIT n (n = 0 - 255) 


default 0 


DWAIT defines a delay to be used to avoid collisions with digipeated packets. 
The value entered for “n” is the number of 10 ms intervals, after last hearing data 
on the channel, for the KPC-3 Plus to wait before it begins its own key-up se- 
quence. 


This value should be established and agreed on by all members of a local area 
network. The best value will be determined by experimentation but will be a 
function of the key-up time (TXDELAY). This feature is made available to help 
alleviate the drastic reduction of throughput which occurs on a channel when 
digipeated packets suffer collisions. Digipeated packets are not retried by the 
digipeater but must be restarted by the originating station. If all stations specify 
DWAIT, and the right value is chosen, the digipeater will capture the frequency 
every time it has data to send since digipeated packets are sent without this delay. 


Observations have proven that a better algorithm for avoiding collisions between 
end-user stations, while still allowing digipeaters the high-priority access they re- 
quire is achieved using Persistence and Slottime to determine proper transmit in- 
tervals, and setting DWAIT to 0. 


See also: persist, slottime 


O ECHO {ON | OFF} 


default ON 


When ON, characters received from the computer by the TNC are echoed back 
and displayed. If you are receiving double print of characters entered at the key- 
board, turn this command OFF. This corresponds to the setting in your terminal 
program for duplex. If your program is set for full-duplex set ECHO ON. If your 
program is set for half-duplex (some call it echo) then set ECHO in the TNC to 
OFF. Regardless of the setting of this command, the TNC will not echo an 
X-OFF or X-ON character to the terminal when it receives a STOP or START 
character. Echo is disabled in Transparent Mode. 
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See also: bkondel, flow 


ESCAPE {ON | OFF} 


default OFF 


This command specifies the character which will be sent to the terminal when an 
escape character ($1B) is received in a packet. When OFF, $1B is sent. This is 
useful if your terminal interprets ESC characters as screen positioning commands 
(ANSI). When ON, the escape character is sent as a dollar sign ($). 


FILTER {ON | OFF} 


ml 


default OFF 


When ON, this command will inhibit the printing of control characters (hex $00 - 
$1F) which may be present in monitored packets. This will be useful if you are 
monitoring channel traffic which includes binary file transfers or higher level 
protocols (networks talking to each other). Control characters which may be em- 
bedded in those packets can have strange and unpredictable effects on the moni- 
toring TNC. All control characters except carriage return ($0D) and line feed 
($0A) will be filtered. This command DOES NOT affect receipt of control char- 
acters in packets received from a “connected” station when MONITOR or 
MCON is OFF. 


See also: monitor 


FLOW {ON | OFF} 


default ON 


When FLOW is ON, any character entered from the terminal will halt output to 
the terminal until the current packet or command is completed (by SENDPAC, 

PACLEN, or PACTIME). Canceling the current input to the TNC or typing the 

REDISPLAY-line character will also cause output to resume. FLOW will keep 

the display of received data from interfering with data entry. 
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When FLOW is OFF, received data will be “inter-leaved” with keyboard entry. If 
using a split screen terminal program, you should have FLOW OFF and ECHO 
OFF to allow received data to be displayed while you type into the TNC’s 
type-ahead buffer. 


See also: canline, canpac, cpactime, echo, paclen, redisplay, sendpac 


FRACK n (n = 1 - 15) 


default 4 


Each increment specifies | second intervals. After transmitting a packet requiring 
acknowledgment, the TNC waits FRACK seconds before incrementing the retry 
counter and sending the packet again. If the retry count (specified by the RETRY 
command) is exceeded, the current operation is aborted. If the packet address in- 
cludes digipeaters, the time between retries is adjusted to FRACK * ((2 * m) + 1) 
where m is the number of digipeater stations specified. When the retried packet is 
sent, a random wait time is also added to avoid lockups where two units repeat- 
edly collide with each other. 


The FRACK timer begins when PTT is released (the packet has been sent) and is 
suspended when data carrier from the radio is present, or when your station is 
transmitting. 


See also: connect, resptime, retry 


FULLDUP {ON | OFF | LOOPBACK} 


default OFF 


When OFF (i.e., half duplex), the data carrier detect signal is used as a packet 
collision avoidance signal. When ON, the modem is run full duplex, and carrier 
detect does not inhibit transmission. The full duplex mode may be useful espe- 
cially for satellite operations using duplex radio setups. Full duplex should not be 
used unless both you and the station you are communicating with have full du- 
plex capability. LOOPBACK is the same as half duplex (i.e., FULLDUP OFF) as 
far as protocol is concerned, but the receive circuit is still active; this allows you 
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to connect a simple wire between the transmit and receive pins on the radio con- 
nector to verify operation of the modem circuitry. 


GPSHEAD n string (n = 1-4) (string up to 8 chars) 


default 1$GPGGA (string 2, 3, and 4= <blank>) 


This command determines which GPS NMEA sentences will be stored in the LT 
buffers. n (1-4) determines which buffer will be used to store the data, and string 
is a NMEA sentence header. 


When the header is received from the GPS unit, the KPC-3 Plus will store up to 
128 characters in the associated LT buffer. 


+ To clear one of the four strings, enter the buffer number, n (n= 1-4), and nothing 
else, then press the ENTER key. 


See also: bit, It, Itp, Itrack 


GPSINIT string (string up to 128 characters) 


default (blank) 


This command establishes a string which will be sent to the attached GPS unit 
upon power-up (i.e., initial text sent to terminal in GPS Mode). This may be use- 
ful to configure your GPS unit to provide only the information you require. Some 
GPS units may require more than one sentence; consult your GPS unit manual. 
To send more than one, enter a <Ctrl+N> at the end of each sentence, and the 
KPC-3 Plus will send a CR/LF sequence to the GPS unit. A single % will clear 
the string. 


See also: gpshead, intface 


7 


BAUD n (n = 300, 400, 600, 1200) 


default 1200 
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This baud rate specifies the rate of data exchange between the radio stations. The 
value of HBAUD has NO relationship to the terminal baud rate specified with 
ABAUD. In order to communicate with other packet stations, the baud rate must 
be the same at each end of the link. As a general rule, 300 baud is used on fre- 
quencies below 28 MHz, 1200 baud is used on frequencies above 28 MHz. FCC 
rules currently limit the maximum baud rate to 300 when operating below 28 
MHz. Although the KPC-3 Plus can operate 300 baud, the modem tones will still 
use a 800 Hz shift whereas most HF packet uses a 200 Hz shift. 


HEADERLN {ON | OFF} 


default ON 


When ON a carriage return is output to the terminal between the header and text 
of monitored packets. This causes the packet header and time stamp (if on) to be 
displayed on one line, with the packet text displayed below it on the next line. 
When receiving packets addressed only to you (MONITOR and/or MCON OFF) 
this parameter does not apply. When OFF the data will be on the same line as the 
header. 


See also: cstamp, mcon, monitor, mstamp 


oO 
an 


ELP [command] 


immediate 


Entering the word “HELP” alone, without any argument, will generate a display 
listing all commands available in the KPC-3 Plus. 


When the name of a command is entered also (e.g., HELP CONVERS), a brief 
description of that command will be displayed. A wild card also can be used; 
entering “Help C*” will display brief descriptions of all commands beginning 
with C. 


HELP can also be called by entering “?”’. 


User’s Guide 210 KPC-3 Plus v 8.2 


KPC-3 Plus Commands Command Reference 


HID {ON | OFF} 


default ON 


When ON, an ID packet will be sent every 9.5 minutes, provided that packets are 
being digipeated through your station, or routed through your KA-Node, or into 
your PBBS. This command should be ON if digipeating, KA-Node or pbbs is en- 
abled. If OFF, periodic identification packets will not be sent. 


See also: digipeat, id, myalias, mynode, mypbbs, numnodes, pbbs 


FS 
HK 


EXT text 


default blank 


The HTEXT command is used by your PBBS to provide hierarchical routing in- 
formation. Use this command to enter the hierarchical portion of your packet ad- 
dress. Do not enter your callsign or the first period of your packet address. 


A hierarchical address consists of your state, country, and continent codes, sepa- 
rated by periods. Some areas (in large states particularly) use sub-state designa- 
tors. For instance, a station in Rhode Island might use a hierarchical address of 
RILUSA.NOAM. This means Rhode Island (RI) which is in the United States 
(USA) which is in North America (NOAM). In this case, you should set the 
HTEXT to RIUSA.NOAM 


If you are unsure of your hierarchical address, contact your local packet BBS 
sysop and ask what the proper addressing is for your location. Entering “%”’ will 
clear any text previously entered. 


Note: Your PBBS will not forward or reverse forward unless HTEXT is set. 


ID 


immediate 
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When this command is entered an identification packet will be transmitted. This 
command may be used to insure that your station identification is the last trans- 
mission before taking the station off the air. 


The ID packet is an unnumbered information <UI> packet whose data consists of 
your station identification as set in MYCALL and a listing of other modes, if you 
have activated them. 


The MYCALL will be appended with “/R” if DIGIPEAT is ON, MYALIAS 
callsign appended with “/D”, MYNODE callsign appended with “/N”, and 
MYPBBS callsign appended with ‘“/B”. 

This packet will be addressed to “ID” and digipeated via any addresses specified 
in the UNPROTO command. 


See also: hid, unproto 


O INTFACE {TERMINAL |NEWUSER|BBS|KISS|XKISS| 
HOST|GPS | MODEM} 


default NEWUSER 


When set to NEWUSER, the TNC will operate with a standard terminal or com- 
puter running a terminal emulation program with a limited command set avail- 
able. When set to TERMINAL, the full command set of the TNC is available. 
When set to BBS, the TNC deletes certain messages (i.e. *** connect request, 
*** FRMR, etc) for greater compatibility with full-service BBS programs such as 
WORLI, WA7MBL, CBBS, etc. When INTFACE is set to KISS mode of opera- 
tion, users interact with the TNC using software that implements the KISS code 
specified by Phil Karn (for more information, see the KISS Operation section of 
this manual). When INTFACE is set to XKISS mode of operation, users interact 
with the G8BPQ extended KISS protocol (for more information, see the KISS 
Operation section of this manual). When INTFACE is set to HOST, the TNC will 
talk to the attached computer using the Kantronics HOST mode and users com- 
municate with the TNC using “host mode” software (for more information, see 
the HOST Operation section of this manual). 


When INTFACE is set to GPS, the KPC-3 Plus will enter GPS mode upon power 
up. Data from the serial port will be parsed according to the GPSHEAD com- 


User’s Guide 212 KPC-3 Plus v 8.2 


KPC-3 Plus Commands Command Reference 


mand, text will be placed into the LT buffers, and beacons will be transmitted ac- 
cording to the setting of the BLT commands. 


When INTFACE is set to MODEM, the KPC-3 Plus mirrors at the RS-232 port 
@ 1200 baud what it receives at the radio port (for more information, see the 
“modem mode” in the Modes of Operation chapter). 


To have the KPC-3 Plus exit GPS Mode, connect a PC or terminal to it and issue 
three <Ctrl+C> characters (see COMMAND for details). 


For instructions on exiting KISS, XKISS, HOST and MODEM modes, see the 
appropriate sections of the “modes of operation” chapter of this manual. 


NOTE: After changing the setting of this command to KISS, XKISS, HOST, GPS, 
or MODEM a soft reset is required for the new mode to take effect (see RESET 


for details). 


O K 


immediate 


This single letter command is synonymous with CONVERS. It is included as a 
single-keystroke convenience for entering Convers Mode. 


See also: convers 


KNTIMER n (n = 0 - 255) 


default 15 


If there is no activity (data) on a KA-Node circuit for n minutes, the KA-Node 
will disconnect both the input and output sides of the KA-Node circuit. Setting 
KNTIMER to 0 disables this feature. 


See also: rnrtime 
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LCOK {ON | OFF} 


default ON 


When ON, no character translation occurs in the TNC. If OFF, lower case charac- 
ters will be translated to upper case before being output to the terminal from the 
TNC. This case translation is disabled in Packet Transparent Mode. 


LEDS {ON | OFF} 


default ON 


To conserve power, disable the indicators (LEDS) on the front-panel of the 
KPC-3 Plus by setting LEDS to OFF. 


LFADD {ON | OFF} 


default OFF 


When ON, a line-feed will be appended to every carriage return received from 
the keyboard before being transmitted. When OFF, no line feeds will be added to 
the transmitted signal. 


LFSUP {ON | OFF} 


default OFF 


When ON, this command suppresses any line-feed characters received from the 
other station, relying on your terminal program to properly advance to the next 
line. When OFF, the line-feeds received from the other station are not suppressed 
but are sent to your terminal as received. 


See also: autolf, crsup 
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LLIST [ON | OFF] [NONE | {+|-}callsign | 
callsignl,callsign2...] 


default OFF 


LLIST is used to determine which stations (callsigns) may NOT use your station 
for ANY purpose, including digipeating. When LLIST is ON, the TNC will NOT 
recognize those packets received with any callsign that appears in the LLIST’s 
(lid) list of callsigns. In addition, when LLIST is ON, you will not be able to con- 
nect to any station that is on that list. 


The maximum number of callsigns allowed in LLIST is 10. Up to 10 callsigns 
may be entered at once, using the format shown after the command name, and the 
new list of from 1 to 10 callsigns will replace whatever list was there before. The 
LLIST command can be used to add a single callsign (+callsign), so long as there 
is room for the new callsign on the list (if there is not, the TNC responds with 
“EH?” and returns you to the command prompt). Similarly, you can remove a 
single callsign (-callsign) from the list. And to remove all items from the current 
list, enter LLIST NONE. 


A callsign entered without a SSID will match any SSID of that callsign. To match 
a specific SSID only, enter the callsign with that SSID: for example, callsign-n, 
where n = 0-15. 


LT on text (n = 1-4) (text up to 128 chars) 


default blank (forn = 1 - 4) 


This command, used with GPS activity, fills the specified LOCATION Text (LT) 
buffer with “text”. n specifies which buffer to use (1-4). If GPSHEAD is set for 
this buffer, and if the INTFACE command is set to GPS, the buffer contents will 
be updated automatically by the GPS data. 


To clear one of the 4 LT strings, enter “LT n%”, where “n’” is the number of the 
LT string you want to clear. 


See also: blt, gpshead, Itp, Itrack 
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LTP n dest [via calll[,call2,...]] (n =1-4) 


default GPS (forn=1-4) 


This command sets the destination callsign and the digipeaters used to transmit 
the LT strings. n specifies which string (1-4). The destination callsign defaults to 
GPS; however, you may want to change it to APRS, LOCATE, POSIT, or some 
other destination. Up to 8 digipeater callsigns may be specified. 


See also: It 


LTRACK n [LT1] [LT2] [LT3] [LT4] [SYSOP] [TIME] 


default 0 


This command allocates memory for a special tracking buffer used to store LT 
messages. n defines the amount of memory (Kbytes) set aside for the LT mes- 
sages (limited by available RAM). Specifying the LT1 through LT4 parameters 
determines which messages will be stored in the tracking buffer. If SYSOP is 
specified, only a user with SYSOP privileges may access the tracking buffer, and 
if TIME is specified, a time stamp will be included, in front of the LT message. 


Specified LTs are put in the LTRACK buffer based on the BLT settings. 


The LTRACK buffer is accessed by connecting to the mailbox (MYPBBS) and 
using the mailbox’s List Tracking buffer Command (LTR). To see the syntax of 
this command, type HELP at the BBS prompt. 


To change LTRACK, you need to enter the entire command name, LTRACK, not just 
the short form (LTR). 


See also: Itp, blt, GPS operation section 


MALL {ON | OFF} 


default ON 
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When ON, monitored packets include connected and unconnected packets be- 
tween other stations. If OFF, only other station’s unconnected packets (UI 
frames) will not be displayed. 


This is a useful arrangement when stations are talking as a group in an uncon- 
nected configuration. 


See also: monitor 


MAXFRAME n (n = 1- 7) 


default 4 


MAXFRAME sets an upper limit on the number of unacknowledged information 
packets which can be outstanding at any one time. The TNC will send 
MAXFRAME number of packets in a single transmission, if they are available. 


See also: paclen 


MAXUSERS n (n = 1 - 26) 


default 10 


This command causes the TNC to allocate the memory required for the maxi- 
mum number of simultaneous connections you wish to allow. Each connection 
uses a different stream. In order to direct what you want to say to a different 
stream you use the STREAMSW character. All streams may be used for outgoing 
packets, but USERS sets the number that may be used for incoming connections. 
Changing the value of MAXUSERS will cause the TNC to perform a “soft re- 
set”. Note that you may not change the value of MAXUSERS while you are con- 
nected, since this would reset the TNC and cause all existing connections to be 
lost. 
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Note: Although you must spell out the entire command word (MAXUSERS) to 
change the current value of MAXUSERS, you can enter the short form,MAXU, if 
you just want to see the current value of MAXUSERS. 


See also: status, streamsw, users 


MBEACON {ON | OFF} 


default ON 


This command determines whether packets addressed to Beacon or ID will be 
displayed on the screen. 


If you do not wish to display Beacon or ID packets, turn this command OFF. 


See also: beacon, id, monitor 


MCOM {ON | OFF} 


default OFF 


Supervisory (control) packets are not monitored unless MCOM is set ON and 
MON is ON. In addition if your station is connected, control packets are not 
monitored unless MCON is also ON. Control packets, when displayed, are distin- 
guished from information packets by the “<>” and “<<>>” character sets ap- 
pended to the packet header. With these characters, a letter is included to denote 
the type of control packet received, e.g. <<c>> - a connect request packet. The 
types of control packets are listed below. 


<C> Connect request 

<D> Disconnect request 
<DM> Disconnected Mode 

<UA> Unnumbered Acknowledge 


In addition, the following bracketed information will be added to the Information 
packets as appropriate: 


<UI> Unconnected Information frame 
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<Is> Information frame (connected) ; 
s = send sequence number 


See also: ax2512v2, monitor, mresp 


For details on control packets, see the book AX.25 Amateur Packet-Radio 
Link-Layer Protocol Version 2.0 October 1984, available from the ARRL. 


MCON {ON | OFF} 


default OFF 


When OFF, and connected, the TNC will display only those packets addressed to 
you. Any header information displayed will be determined by the settings of 
STREAMEV and STREAMCA. When OFF, and not connected, all eligible pack- 
ets (as determined by other monitor commands) will be displayed. When ON, all 
eligible packets will be displayed, whether connected or unconnected. 


See also: monitor, streamca, streamev 


O MHEARD [SHORT | LONG | CLEAR] 


immediate 


This command causes display of a list of stations heard. An asterisk, *, indicates 
that the station was heard through a digipeater. The date/time the station was last 
heard is also displayed. 


If the S option is used, i.e. MHEARD §, then only the callsigns of the stations 
heard will be displayed. 


If the L option is selected, all callsigns contained in the received packet including 
the digipeater paths, are displayed. For example: 


N@GRG > ID 10/16/88 14:31:30 
VIA TOP,KCI,WOXI 


Here, your station heard NOGRG transmitting an ID packet. NOGRG was also 
using the digipeating path TOP, KCI, WOXI. If your station heard NOGRG via 
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one of these other stations, an asterisk would show by the call or alias of the last 
digipeater heard. When listed short, the asterisk would show beside NOGRG. 


+ Whenever PASSALL is ON, packets will not be checked for errors and no addi- 
tions will be made to the MHEARD list. 


If the C option is used, the list is cleared. 


See also: daytime, passall 


MHEADER {ON | OFF} 


default ON 
When ON, the headers are displayed for all monitored packets. 


When OFF, headers are not displayed and only data is output to the terminal. 
Since only I and UI frames have data, only these frames are displayed. 


+ To avoid confusion when MHEADER is OFF, use BUDLIST to restrict the moni- 
tored data. 


See also: monitor,mcon,mbeacon,mall,suplist,budlist 


O MONITOR {ON | OFF} 


default ON 


When ON, unconnected packets will be monitored unless prohibited by 
SUPLIST, BUDLIST, CONLIST, or LLIST. This will also allow monitoring of 
other packets if permitted by the other monitor commands. The MONITOR com- 
mand acts as a master switch for the MALL, MCOM, MCON, MRESP, and 
MRPT commands. The addresses in the packet are displayed along with the data 
portion of the packet. Callsigns (to and from fields) are separated by a “>”; and 
the Secondary Station Identifier (SSID) is displayed if it is other than 0. If any 
data is contained in the monitored packet which does not follow the AX.25 proto- 
col, it is displayed in curly braces on the header line. All monitor functions are 
disabled in the Transparent Mode. 


User’s Guide 220 KPC-3 Plus v 8.2 


KPC-3 Plus Commands Command Reference 


When OFF, you will see just the data from those stations connected to you, no 
matter how other monitor commands are set. Any header information displayed 
will be determined by the settings of STREAMCA and STREAMEV. 


See also: budlist, conlist, headerln, Ilist, mall, mbeacon, mcom, mcon, mresp, 
mrpt, mstamp, pid, streamca, streamev, suplist 


MRESP {ON | OFF} 


default OFF 


When ON, monitored packets include the following AX.25 response packets, if 
MONITOR and MCOM are ON. If connected, MCON must also be on. The 
bracketed information will appear at the end of the header information. The “<” 
and “<<” characters are used to bracket and denote packets received as version 1 
or version 2, respectively. For example, “<<RR1>>” denotes a version 2 packet. 
In addition upper case characters are used to designate commands (polls) and 
lower case characters are used to denote responses for RR, REJ, and RNR. For 
example, “<<rrl>>” is a response in version 2. 


<FRMR> Frame Reject 
<REJr> Reject, r = received sequence number 
<RNRr> Device busy, r = received sequence 
number 
<RRr> Receive Ready, r = received sequenc 
number 


In addition, the following bracketed information will be added to the Information 
packets as appropriate: 


<Isr> Information frame (connected); 
s = send sequence number, 
r = received sequence number 


See also: ax2512v2, mcom, monitor 


For more information, see the book 4X.25 Amateur Packet-Radio Link-Layer 
Protocol Version 2.0 October 1984, which may be obtained from the ARRL. 
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MRPT {ON | OFF} 


default ON 


This command affects the way monitored packets are displayed. If ON, the entire 
digipeat list is displayed for monitored packets, and the station that relayed the 
packet is indicated with an asterisk. The MONITOR command must be ON for 
this command to work, and if connected MCON must also be ON. If OFF, only 
the originating station and the destination station callsigns are displayed for mon- 
itored packets. 


See also: monitor 


MSTAMP {ON | OFF} 


default OFF 


This command enables time stamping of monitored packets. The date and time 
information is then available for use for automatic logging of packet activity or 
other computer applications. The date and time are set initially by the DAYTIME 
command, and the date format is determined by the DAYSTR command. The 
MONITOR command must be ON for this command to work, and if connected 
MCON must also be ON. 


See also: cstamp, daytime, monitor 


XMIT {ON | OFF} 


default ON 


When ON, the KPC-3 Plus will display transmitted packets as monitored data on 
your terminal. Repeated packets will be displayed as they are sent over the radio. 
The frames to be displayed will be controlled by the MONITOR, MCOM, 
MCON, and MRESP commands, and will obey the settings of TRACE, 
MSTAMP, HEADERLN, 8BITCONV and FILTER commands. 


See also: monitor 
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MYALIAS XXXXXX—-N (n = 0-15) 


default (blank) 


Setting this command to a callsign or character string enables digipeating by us- 
ing the MYALIAS. Enter up to six characters (plus optional SSID) which are dif- 
ferent than those used for MYCALL, MYNODE, MYPBBS, or MYREMOTE. 
For example: you may enter LAW-3 as the MYALIAS, which would be easier to 
remember for stations wishing to digipeat through a station in Lawrence, enroute 
to a station more distant. You may disable the alias digipeating with the com- 
mand MYALIAS %. 


See also: hid 


O MYCALL XXXXXX—-N (n = 0-15) 


This command tells the TNC what its callsign is. 


The extension n is called a Secondary Station Identifier (SSID) and is defaulted 
as 0, but may be any number from 0 to 15. All packets originated by the TNC 
will contain this callsign in the FROM address field. Any packets received by the 
TNC with this callsign in the TO address field or digipeat fields will be re- 
sponded to appropriately (connect, disconnect, ack, digipeat, etc.). 


+ When the TNC is first turned on out of the box, or after a hard reset, it asks you 
for your callsign - there is no default. The callsign you enter then for MYCALL 
is automatically used to compute other IDs too (MYPBBS, MYNODE, and 
CWIDTEXT), adding an SSID for each. Changing MYCALL at the “cmd:” 
prompt does not affect MYPBBS, MYNODE, or CWIDTEXT 


See also: cwidtext, digipeat, id, myalias, mynode, mypbbs, myremote 


default 0 
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This command sets the KISS address of the radio port in the KPC-3 Plus. A KISS 
frame with the upper nibble of the command byte set to this value will address 
this KPC-3 Plus. 


See also: intface, KISS operation section 


MYNODE XXXXXX—-N (n = 0-15) 


default mycall-7 


Setting this command to a callsign or character string enables the KA-Node in 
the TNC. Enter up to six characters (plus optional SSID) which are different than 
those used for MYCALL, MYALIAS, MYPBBS, or MYREMOTE. 


You must also have the NUMNODES command set to a non-zero value. 


You may disable the KA-Node by setting MYNODE to the same as MYCALL, 
or setting NUMNODES 0. 


See also: digipeat, ndwild, numnodes; KA-Node section 


O MYPBBS XXXXXX—-N (n = 0-15) 


default mycall-1 


This command is used to set the callsign (address) of your Personal Packet Mail- 
box. Entering a callsign with or without an SSID, -n, defines the address. The six 
characters and optional SSID must be different than those entered for MYCALL, 
MYALIAS, MYNODE, or MYREMOTE. 


See also: pbbs 


YREMOTE XXXXXX-—N (n = 0-15) 


default (blank) 


This command sets the callsign used for remote access of the TNC. Enter up to 
six characters (plus optional SSID) which are different than those used for 
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MYCALL, MYALIAS, MYNODE, or MYPBBS. In addition, the RTEXT must 
be programmed with a text string. A station that connects will be sent a series of 
numbers that must be decoded according to RTEXT. 


See also: rtext; remote access section 


NDHEARD [SHORT | LONG | CLEAR] 


immediate 


This command allows the operator to display a list of nodes whose ID packets 
have been heard by the TNC. The list includes KA-Nodes as well as K-Net, 
TheNet, NET/ROM and G8BPQ nodes. 


K-Net, TheNet, NET/ROM and G8BPQ nodes are identified as: 
ALTAS (CALLSIGN) 

and Kantronics KA-Nodes will be identified as: 
MYNODE (MYCALL) 


An asterisk"*" indicates that the station was heard through a digipeater. The 
date/time the station was last heard is also displayed. If the S option is used, i.e. 
NDHEARD §S, then only the callsigns of the stations heard will be displayed. 
If the L option is selected, all callsigns contained in the received packet are dis- 
played (see MHEARD for display format). If the C option is used, the list of 
nodes is cleared. 


See also: mynode 


NDWILD {ON | OFF} 


default OFF 


When OFF, the KA-Node will only recognize connect requests directed to the 
MYNODE call. When ON, connect requests to any SSID of the MYNODE call 
will be recognized as connects to the KA-Node, if that SSID is not being used for 
any other ID in the TNC. 
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See also: myalias, mycall, mynode, mypbbs, myremote 


NEWMODE {ON | OFF} 


default ON 


When ON, the TNC will return to Command Mode if the station on the current 
I/O stream disconnects. The TNC will not return to Command Mode if the station 
disconnecting is on a different stream. When OFF, a disconnect will not cause the 
TNC to change modes. 


See also: connect, disconnect, status 


NOMODE {ON | OFF} 


default OFF 


When OFF and a connection takes place, the TNC will change to whatever mode 
is specified in CONMODE. When ON, the TNC stays in Command Mode after 
connecting to another station; that is, it does not immediately change to Convers 
or Transparent Mode. 


See also: conmode, connect 


E 
Ij 


EXT text (up to 128 characters) 


default (blank) 


This entry specifies customized text to be sent with the initial KA-Node sign-on 
message (when a remote station connects to a KA-Node). Enter any combination 
of characters and spaces up to a maximum length of 128. Entering a single “%” 
will clear NTEXT. 


See also: mynode, numnodes 


User’s Guide 226 KPC-3 Plus v 8.2 


KPC-3 Plus Commands Command Reference 


NUMNODES n (n = 0-26, depending on available RAM) 


default 0 


This command is used to set the number of allowable circuits through the 
KA-Node. For example, if you wish to allow up to 3 simultaneous circuits 
through the node, set NUMNODES 3. 


+ Changing the value of NUMNODES will cause a soft reset. 


Approximately 4K of RAM is used for each circuit. The amount of RAM avail- 
able will depend on how much RAM has been used for the PBBS, MAXUSERS, 
and MYREMOTE parameters. If you select n larger than available RAM will al- 
low, a “Not enough RAM” message will be returned to you. Generally, set the 
amount of RAM required first for your PBBS (personal bulletin board) and then 
set the desired number of circuits. For example, if you have 32K RAM and n is 
set to 5 you can only have a 1K mailbox. In this case, if n is larger than 5, a ‘mes- 
sage saying “not enough RAM” will be returned to you. 


Note: While you need to enter all the letters of the command name to change the 
value of NUMNODES, you can enter the short-form, NU, to see the current value 
of NUMNODES. 


See also: mynode; KA-Node section 


PACLEN n (n = 0 - 255) 


default 128 


This command specifies the maximum length of the data portion of a packet. The 
TNC will automatically send a packet when the number of input bytes reaches n. 
This value is used in both Convers and Transparent Modes. A value of 0 means 
256 bytes. 


See also: maxframe 
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PACTIME [EVERY | AFTER] n (n = 0 - 255) 


default After 10 


This command is used to pace the formation (and transmission) rate of packets in 
Transparent mode or in Convers mode if CPACTIME is ON. In addition, a 
PACTIME timer is necessary in transparent mode, since the SENDPAC charac- 
ter is ignored and treated as data. The timer is not started until at lease one byte 
is entered for a packet; hence, a zero data length packet is never formed and sent. 


When AFTER is specified, bytes are packaged (if any available) when input 
from the terminal stops for n*100 ms or when PACLEN is reached. When 
EVERY is specified, input bytes are packaged (if available) and queued for trans- 
mission every n*100 ms or when PACLEN is reached. 


See also: cpactime, trans 


PASS n (n = $00 - SFF) 


default $16 <Ctrl+V> 


This command selects the ASCII character used to allow the passage of any char- 
acters in Converse Mode. 


For example, if you wish to send a COMMAND character (<Ctrl+C>) as part of 
the packet, you can do so by preceding it with the PASS character. The command 
character will be sent rather than returning the TNC to Command Mode. In 
Transparent Mode all characters are passed, there are no special functions except 
the one combination to get out of transparent mode. However, see TRFLOW. 


PASSALL {ON | OFF} 


default OFF 


This command enables the attempt to display corrupted packets when PASSALL 
is ON. Ifa packet contains beginning and ending flags, the TNC will attempt to 
decode the address field as well as the data field and display the packet as speci- 
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+ 


fied by other commands such as MONITOR. MHEARD and NDHEARD log- 
ging are disabled when PASSALL is ON. 


When PASSALL is OFF, packets will be displayed only if the CRC (error check- 
ing) is correct and as specified by other commands such as MONITOR. 


oO 


PBBS n (maximum value of n depends on available RAM) 


default 5 (If RAM = 32K), 100 Gif RAM = 128K), or 480 (if RAM = 512K) 


Setting n greater than 0 allocates memory and activates the Personal Mailbox in 
the TNC. The amount of memory allocated will be n kilobytes, and may be lim- 
ited by other functions that require memory (e.g. NUMNODES and 
MAXUSERS). Changing the size of the PBBS memory allocation will not affect 
the contents of the mailbox (messages will be preserved). If you attempt to set 
the PBBS smaller than is required for existing messages you will receive the 
message “Messages would be lost” and no change will be made to the mailbox 
size. In this case to reduce the size of the mailbox you must first either kill some 
of the messages or set PBBS 0 which will delete all messages; then set the new 
size. Using the PBBS n command with n equal to the current size will renumber 
the messages in the mailbox beginning with message number 1. If n is a different 
size, the messages will not be renumbered. This command causes a soft reset if n 
is different from its previous value. 


Note: To change the value of PBBS you must enter the whole command name 
(PBBS), but to see the current value, you only need enter the short-form PB. 


See also: cmsg, mypbbs, pbheader, pblo, pbperson, ptext; PBBS section 


PBFORWRD [bbscall [VIA calll,call2,...call18] ] 
[EVERY | AFTER n] 


default NONE EVERY 0 


This command will cause your PBBS to attempt to initiate a forward of any eligi- 
ble mail to another BBS system periodically. Any message in your PBBS which 
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contains an @BBS field and is not being HELD (H) or has not previously been 
FORWARDED (F) is eligible for forwarding. If the keyword EVERY is used, 
the PBBS will attempt to forward once every n hours. If you specify the keyword 
AFTER, the PBBS will attempt to forward whenever a user disconnects from the 
PBBS, and every n hours after that. Setting the time interval will cause the PBBS 
to attempt to forward immediately. 


After the PBBS has initiated a forward, it will also request a reverse forward if 
PBREVERS is ON. Note that full-service BBS systems must be configured to al- 
low your station to reverse forward mail to you. 


Note: Your PBBS will not forward or reverse forward unless HTEXT is set. 


See also: pbrevers,htext 


PBHEADER {ON | OFF} 


default ON 


When ON the routing headers received from a full service BBS will be stored in 
the PBBS mailbox. When OFF, these headers are not stored in the mailbox, al- 
lowing messages to require considerably less space. The routing headers are 
those lines you normally see in messages beginning with R:. Note that the PBBS 
will ignore all lines beginning with R: until it sees the first line that does not have 
R: in column one. From that point on, all of the message will be stored, even if a 
line begins with an R:. 


See also: PBBS section 


PBHOLD {ON | OFF} 


default ON 


When ON, any message received over the radio will automatically be held by 
your PBBS for you to review. You may then release the message for forwarding 
by editing it and changing the H flag (for example, to edit message number 4: E 4 
H). When OFF, messages received over the radio are not held, but may immedi- 
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ately be forwarded from your PBBS. (Note that any message addressed TO or 
@ your MYCALL or MYPBBS call will be held regardless of the setting of 
PBHOLD.) 


PBKILLFW {ON | OFF} 


default OFF 


When OFF, Private and Traffic messages will not be deleted (killed) from your 
PBBS after they have been forwarded, but will be marked with an F flag (for- 
warded). When ON, Private and Traffic messages will be deleted from the PBBS 
after they have been successfully forwarded. 


PBLIST [ON | OFF] [NONE | {+ |-}callsign | 
callsignl,callsign2...] 


default OFF 


The front panel of your TNC has a mail-status indicator that blinks when there 
is unread mail in your PBBS addressed to your callsign (MYCALL) or to your 
MYPBBS. And several PBBS commands (LISTMINE, READMINE, and 
KILLMINE) operate on mail addressed to your callsign (MYCALL) or to 

your MYPBBS. 


PBLIST allows you to add up to ten more callsigns to the set of callsigns 
included as “mine” for use with the “mail” indicator and the PBBS commands 
(LISTMINE, READMINE, and KILLMINE). The PBLIST command has two 
parameters: one for creating, changing, or deleting the list of callsigns on the 
PBLIST and the other for turning ON or OFF the use of the callsigns on the cur- 
rent PBLIST. 


SSID’s attached to callsigns are always ignored in the mailbox. 


The maximum number of callsigns allowed in PBLIST is 10. Up to 10 callsigns 
may be entered at once, using the format shown after the command name, and the 
new list of from 1 to 10 callsigns will replace whatever list was there before. The 
PBLIST command can be used to add a single callsign (+ callsign), so long as 
there is room for the new callsign on the list (if there is not, the TNC responds 
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with “EH?” and returns you to the command prompt). Similarly, you can remove 
a single callsign (-callsign) from the list. And to remove all items from the cur- 
rent list, enter PBLIST NONE. 


When you change PBLIST, the new list of callsigns takes effect immediately for use 
with the PBBS commands (LISTMINE, READMINE, and KILLMINE). But the new 
list will not be used with the mail-status indicator until after the next disconnect 
from the PBBS or the next reset. 


When PBLIST is ON, the callsigns on the current PBLIST list are included as 
“mine” for use with the “mail” indicator and the PBBS commands (LISTMINE, 
READMINE, and KILLMINE). Your callsign (MYCALL) and your MYPBBS 
are also included as “mine” when PBLIST is ON. 


When PBLIST is OFF, only your callsign (MYCALL) and your MYPBBS are 
included as “mine” for use with the “mail” indicator and the PBBS commands 
(LISTMINE, READMINE, and KILLMINE). 


+ Hint: Some uses of PBLIST to give you additional use of your “mail” indicator 
(and the PBBS commands shown above) would be to include on PBLIST: 
(1) callsigns of family members who are also hams, (2) old callsigns that people 
might still be using for you, and/or (3) callsigns that are common errors in trying 
to reach you (e.g., replacing a “zero” with an “O" in your callsign). 


PBL [OLD | NEW] [FIXED | VARIABLE] 


default NEW VARIABLE 


When set to OLD the PBBS will list messages to the user from oldest to newest 
(i.e. ascending numerical order). When set to NEW, the newest message will be 
listed first. When the second parameter is set to FIXED, the user cannot change 
the listing order. When the second parameter is set to VARIABLE, the user may 
change the order in which messages will be listed by using the LO command 
within the PBBS. 


See also: PBBS section 
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PBPERSON {ON | OFF} 


default OFF 


When OFF, the personal mailbox will allow messages to be sent to any callsign. 
When ON, only messages addressed to the MYCALL , MYPBBS or PBLIST 
callsigns will be accepted over the radio, but a message entered from the terminal 
or by the SYSOP may be addressed to anyone. 


See also: mycall, mypbbs, pbbs 


PBREVERS {ON | OFF} 


default ON 


When ON, the KPC-3 Plus PBBS will request a reverse forward from another 
BBS after it has finished forwarding any mail to the other BBS. This does not af- 
fect the ability of another BBS to reverse forward from your PBBS, but only af- 
fects the action taken by the KPC-3 Plus after it has initiated a forward 
(PBFORWRD command). Note: Your PBBS will not forward or reverse forward 
unless HTEXT is set. 


See also: pbforwrd 


PERSIST n (n = 0 - 255) 


as) 


default 63 


This command, used with SLOTTIME, implements an algorithm for channel ac- 
cess to send packets. The algorithm used to determine whether or not to transmit 
using the PERSIST/SLOTTIME method has been shown to be considerably more 
efficient than the DWAIT method used by most standard AX.25 packet stations. 
The result of using the persistence algorithm is increased throughput under most 
channel conditions. 


The value of “n” is used to determine if a packet will be sent after SLOTTIME 
expires. For example, let’s assume a PERSIST setting of 63 and a SLOTTIME 
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setting of 10. This slottime setting corresponds to 100 milliseconds. When the 
TNC detects that the channel is clear and available (no carrier is detected), it 
starts a tmer (SLOTTIME). When the timer expires (100 ms in our case) the 
TNC generates a random number between 0 and 255. If the generated number is 
equal to or less than the PERSIST value, the TNC keys up the transmitter and 
sends the data packet. With our setting of 63 the odds of this occurring after the 
first slottime are | in 4. (Actually the probability is PERSIST plus | divided by 
256.) If the TNC generated random number is greater than PERSIST, the TNC 
restarts the timer and waits for the timer to expire again before generating a new 
random number. This is repeated until the TNC gains channel access and sends 
its packet of information. 


Making SLOTTIME smaller will cause the TNC to generate the random number 
more frequently, whereas raising the PERSIST value will give a better chance 
(improve the odds) of transmitting the data. Through careful choice of these val- 
ues, it is possible to improve data throughput while at the same time permitting 
shared channel usage by other packet stations. The persistence algorithm has 
been added on top of the DWAIT algorithm. 


See also: slottime 


PHEARD [CLEAR] 


immediate 


This command will display a list of the last 10 stations that have connected to 
your KPC-3 Plus PBBS. The list will show the callsign of the connecting station 
and the last time they connected and disconnected. 


To clear the PHEARD list of all current entries, enter PHEARD CLEAR. 


See also: passall 


PID {ON | OFF} 


default OFF 
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When OFF only those packets with a protocol ID of $F0 (pure AX.25) are dis- 
played. When ON all packets are displayed. Some of the information in 
non-AX.25 packets (for example: TCP/IP, NET/ROM or TheNet) can cause some 
computers to lock up. Net/Rom, TheNet and G8BPQ nodes have a PID of $CF, 
TCP/IP uses $CC and $CD, and standard AX.25 is $FO. 


PMODE {CMD | CONV | TRANS} 


default CMD 


The PMODE command controls the mode your KPC-3 Plus will be in when it is 
first powered up or reset. When set to CMD, the KPC-3 Plus will produce a 
sign-on message followed by the command prompt. When set to CONV, the unit 
will be in the Convers Mode. Setting PMODE TRANS sets the KPC-3 Plus in 
Transparent Mode. Exiting Transparent Mode with three <Ctrl+C>s will put the 
KPC-3 Plus in Command Mode. 


PTEXT text (up to 128 characters) 


default (blank) 


This entry specifies the customized text sent with the initial PBBS (personal 
mailbox) sign-on message. Enter any combination of characters and spaces up to 
a maximum length of 128. Entering a single “%” will clear PTEXT. Don’t use 
the “>” character in your PTEXT, as this is reserved by BBS systems for their 
prompt. 


See also: pbbs 
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REDISPLA n (n = $00 - S$FF) 


default $12 <Ctrl+R> 


This command is used to change the REDISPLAY input editing character. The 
parameter n is the ASCII code for the character you want to type in order to 
REDISPLAY the packet or command currently being entered. 


You can type this character to cause the TNC to redisplay the packet you have 
begun. When you type the REDISPLAY-packet character, the following things 
happen: First, type-in flow control is released (if FLOW was enabled). This dis- 
plays any incoming packets that are pending. Then a \ (backslash) character is 
displayed, and the packet or command you have begun is redisplayed on the next 
line. If you have deleted and retyped any character, only the final form of the 
packet will be shown. You are now ready to continue typing. Incoming packets 
will continue to be displayed until you type the next character of your current 
message. 


You can use the REDISPLAY-packet character to see a “clean” copy of your in- 
put if you are using a printing terminal (or have BRKONDEL OFF) and you have 
deleted characters. The REDISPLAYed packet will show the corrected text. 


You can also use this character if you are typing a message in Convers Mode and 
a packet comes in. You can see the incoming message before you send your 
packet, without canceling your input. 


See also: bkondel, canline, canpac, flow 


RELINK {ON | OFF} 


default OFF 


When OFF, the TNC operating with AX25L2V2 ON does not attempt to auto- 
matically reconnect. When ON, the TNC operating with AX25L2V2 ON will at- 
tempt to automatically reconnect after RETRY is exceeded. 


The KA-Node and the PBBS will never attempt to reconnect regardless of the 
setting of this command. If using AX.25 Level 2 Version | (AX25L2V2 OFF) 
this command has no effect. 
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See also: ax2512v?2, retry, tries 


O RESET 


immediate 


This command is used to perform a soft reset. Contents of the mailbox (PBBS) 
are kept, and the NDHEARD and MHEARD logs are not cleared. Any existing 
connections which are not conpermed will be lost, even though the other station 
still indicates a connection to your station. The initial sign-on message will be 
displayed. 


See also: intface, maxusers, myremote, numnodes, pbbs, restore 


RESTORE 


iS) 


EKFAULT 


immediate 


When RESTORE D is given, the KPC-3 Plus will revert to it’s factory default 
settings, perform it’s AUTOBAUD routine, and erase PBBS memory (deleting 
all messages and non-default PBBS parameter settings). 


See also: reset 


RETRY n (n = 0 - 15) 


default 10 


This command specifies the number of packet retries. Packets are re-transmitted 
n times before an operation is aborted. The time between retries (when no ac- 
knowledgment is received) is specified by the command FRACK. 


See also: ax251]2v2, frack, relink, tries 
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RING {ON | OFF} 


default ON 


When ON, three bell characters ($07) are sent to the terminal with each “*** 
CONNECTED TO” message (when another station initiates the connect). 


RNRTIME n (n = 0 - 255) 


default 0 


RNRTIME is set in 10 second increments. If a connection stays in a remote de- 
vice busy state (continues to receive RNR frames) for RNRTIME, the TNC will 
disconnect. If a KA-Node connection stays in a remote device busy state for 
RNRTIME the KA-Node will disconnect the input and output sides of the 
KA-Node circuit. Setting RNRTIME to 0 disables this function. 


See also: mresp 


PRINT text (text up to about 250 characters) 


immediate 


This is an immediate command which sends the “text” string to the device 
attached to the RS232 port (e.g. a GPS unit). It is intended to allow a remote 
SYSOP (connected to the KPC-3 Plus with the MYREMOTE callsign) to send a 
string to a unit attached to the KPC-3 Plus serial port. The string content could 
be used to change the configuration of a GPS unit. 


RTEXT text (text up to about 250 characters) 


default (blank) 


This command sets the password string for use when accessing the MYREMOTE 
or when performing SYSOP functions in the PBBS remotely. When you connect 
to the MYREMOTE or attempt to enter the SYSOP mode of the PBBS, the TNC 
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will send three sets of numbers, one of which must be properly decoded (match- 
ing position number with string character) using this string. 


For instance, if the RTEXT is set to “This is my RTEXT string” and you connect 
to the MYREMOTE, the TNC would send three sets of random numbers. The 
numbers would look like: 


5 20 14 7 18 3 
YA Ae A 8 ES 
93 812 22 1 


You must then pick ONE of these lines and decode the password string (i.e., as- 
sign letters to each letter position). Let’s say you choose to decode line 3 (9 3 8 
12 22 1). Rewriting the RTEXT string to make this easier we have: 


a 2 
12345678901234567890123 
This is my RTEXT string 


6699 co 88 
1 


Now, decoding the string, character 9 is ““m” character 3 is “i”, character 8 is 
(i.e., blank), character 12 is “R”, character 22 is “‘n”, and character 1 is “T”. 


You must send the following in response to the string of numbers: 
mi RnT 
If correct, you'll receive the MYREMOTE prompt (“prompt:’’). 
+ Note that case is significant and spaces are considered valid characters. 


If you fail to properly decode the password, the remote KPC-3 Plus will send 
three new lines of numbers. You will be given a maximum of three attempts to 
properly decode the password string. If you fail in three attempts, the TNC will 
disconnect. After failing in three attempts, the MYREMOTE is disabled for 15 
minutes. 


SCREENL n (n = 0 - 255) 


default 0 
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This value is used to format what is sent to your terminal. A “CR” sequence is 
sent to the terminal at the end of a line when n characters have been printed. A 
value of zero inhibits this action. 


See also: autolf 


(2) 


SENDPAC n (n = $00 - SFF) 


default $0D <Ctrl+M> (CR or ENTER) 


This command specifies a character that will force a packet to be sent in Convers 
Mode. In the Convers Mode, packets are sent when the SENDPAC character is 
entered or when PACLEN is achieved. 


See also: cpactime, cr 


SLOTTIME n (n = 0 - 255) 


default 10 


n specifies the amount of time, in 10 millisecond increments, between successive 
tries of the persistence algorithm. 


See also: persist 


START n (n = $00 - SFF) 


default $11 <Ctrl+Q> 


This command specifies the character sent by the computer to the TNC to restart 
output from the TNC. If set to $00 only hardware flow control will be used. For 

software flow control, set this parameter to the character the computer will send 

to restart data flow. 


See also: stop, xflow, xoff, xon 
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O STATUS [LONG] 


immediate 


Entry of the STATUS command will display the number of bytes available 
(i.e., free bytes) in the RS232 input buffer, the current I/O stream ,and any 
streams having a connected status. 


Entering LONG will cause the TNC to display the status of all streams allowed 
by MAXUSERS, PBBS, NUMNODES, and MYREMOTE. 


The current KA-NODE input and output (IO) stream is also indicated. A pound 
sign (#) indicates that there is unacknowledged data in the buffers for that stream. 
The number immediately following the # is the number of bytes outstanding. The 
number in parentheses is the number of packets not yet acknowledged. 


The following is an example of a display (using STATUS LONG). A, B, C, 
through J (i.e, MAXUSERS = 10) indicate the stream. “A” stream is connected 
to KEOSM and has 50 bytes in 2 packets that are unacknowledged. The current 
stream (IO) is the “B” stream, which is connected to NOKN. KBONYK is con- 
nected on circuit “A” of the KA-Node. All other streams, node circuits, the BBS, 
and the remote access are disconnected. Appending ‘“/P” to the callsign indicates 
that the connection is permanent (see CONPERM). 


cmd:status long 
FREE BYTES 1661 


A stream - #50(2) CONNECTED to KE@SM 
B stream - IO CONNECTED to N@KN/P 

C stream - DISCONNECTED 

J stream - DISCONNECTED 


BBS DISCONNECTED 
REM DISCONNECTED 
Ain CONNECTED to KB@ONYK 
Aout DISCONNECTED 

Bin DISCONNECTED 

Bout DISCONNECTED 


See also: conperm, maxusers, myremote, numnodes, pbbs, streamsw 
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STOP n (n = $00 - SFF) 


default $13 <Ctrl+S> 


This command specifies the character sent by the computer to the TNC to stop 
output from the TNC. If set to $00 only hardware flow control will be used. For 
software flow control set this parameter to the character the computer will send 
to stop data flow. 


See also: start, xflow, xoff, xon 


STREAMCA {ON | OFF} 


default OFF 


When receiving packets addressed only to you (MONITOR OFF and/or MCON 
OFF), setting this command ON will enable the display of the callsign of the con- 
nected-to station following the stream identifier of the connection (controlled by 
STREAMEYV). This is especially useful when operating with multiple connec- 
tions allowed. 


See also: mcon, monitor, streamev 


STREAMEV {ON | OFF} 


default OFF 


When OFF, the stream indicator is displayed only when a change in streams oc- 
curs. When ON, the stream indicator will be displayed with every incoming 
packet. This command takes effect only when receiving those packets addressed 
to you and MCON is OFF. 


See also: mcon, monitor, streamca, streamsw 
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STREAMSW n (n = $00 - SFF) 


default $7C (|) 


This command selects the character to be used to signify that a new “stream” or 
connection channel is being addressed. To change streams you must type this 
streamswitch character followed immediately by the stream designator. The 
stream designator is an alphabetic character A through Z, or a through z, limited 
by the value of MAXUSERS. 


+ IfSTREAMSW is set to the dollar sign ($24) you will need to enter parameter 
values in decimal. Alternatively, precede the $ with the PASS character in order 
to enter hex numbers. 


The character selected can be PASSed in the Convers Mode by using a special 
PASS character, and will always be passed as data in the Transparent Mode. If 
operating in the Transparent Mode and you wish to change streams, you must 
first return to the Command Mode. 


See also: maxusers, pass, status 


SUPLIST [ON|OFF] [NONE | {+]-}call | calll,call2,..] 
where call={callsign | {<|>}callsign | 
callsign{>|<>}callsign} 


default OFF NONE 


SUPLIST is used to determine which received packets will not be displayed, i.e. 
suppressed. When OFF or NONE, SUPLIST will not prevent the display of 
packets, even if it has callsigns in it’s list. 


The maximum number of callsigns allowed in SUPLIST is 10. Up to 10 callsigns 
may be entered at once, using the format shown after the command name, and the 
new list of from 1 to 10 callsigns will replace whatever list was there before. The 
SUPLIST command can be used to add a single callsign (+callsign), so long as 
there is room for the new callsign on the list (if there is not, the TNC responds 
with “EH?” and returns you to the command prompt). Similarly, you can remove 
a single callsign (-callsign) from the list. And to remove all items from the cur- 
rent list, enter SUPLIST NONE. 
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A callsign entered without a SSID will match any SSID of that callsign. To match 
a specific SSID only, enter the callsign with that SSID: for example, callsign-n, 
where n = 0-15. 


Selective display is enabled when one or two callsigns are combined with a “>” 
and/or “<” character. For example, entering “>callsign” will disable display of 
packets TO that callsign (assuming SUPLIST is ON), entering “<callsign” will 
disable display of packets from the callsign, entering “callsign1>callsign2" will 
block display of packets from callsign1 to callsign2, and entering 
*callsignl<>callsign2" will block display of packets from callsign! to callsign2 
and vice versa. 


+ Note that entering call>call or call<>call counts as two of the 10 maximum 
allowed callsigns. 


See also: monitor 


SWP UPd pe 


default 17,17,108 


This command sets the parameters used for software carrier detect. The first 
number (u) is used to increment a counter when a valid mark/space or 
space/mark transition occurs in the received signal (i.e. transition occurs at the 
beginning of a bit time). The second number (d) is a penalty subtracted from the 
counter when a transition occurs in the middle of a bit time. The t value is the 
threshold value - when the counter total reaches this value, the carrier detect will 
be set true. 


The values need to be separated by commas as they are entered (as shown). Also 
as shown, spaces between values are not necessary — but entering spaces after 
the commas is OK. 


Once carrier detect is active, the counter must drop to 0 before carrier detect is 
again made false. 


See also: cd 
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TEL 


EMTRY n (n= 0 - 255) 


default 0 


A telemetry beacon is sent every n*10 seconds. If n = 0, the beacon is disabled. 
The telemetry beacon is a UI frame sent to BEACON. If there is a current 
UNPROTO digipeat path, it will be used to transmit the telemetry beacon. 


The data in the UI frame is in the form: “T#nnn,an0,an1,an2,an3,an5,bbbbbbbb”, 


where: 


“nnn” is a decimal count for the telemetry beacon and is incremented 
each time the beacon is sent. When first used, or after the unit is reset, 
the beacon counter begins at 001 (T#001). After reaching 999 (T#999), 
the counter cycles around to 000 (T#000). 


“anO", ’anl", “an2", ”an3", and “an5" are the decimal readings on the 
corresponding analog inputs of the 68HC11F1 (the KPC-3 Plus 
microprocessor). 


Hint: See ANALOG command for more information. 


“bbbbbbbb” is the binary reading of the 8 pins on PORT E of the 
68HC11F (PORT E isa shared port with the analog inputs), where 

“b” = “1" means a Logic High on the pin and ”b" = “O" means a Logic 
Low on the pin. The first ’b" in the string of 8 binary digits is the most 
significant bit of PORT E and the last “b” is the least significant bit of 
PORT E. 


Hint: For details on the 8 pins on PORT E, see the KPC-3 Plus sche- 
matic. 


See the documentation on APRS for more information on the use of telemetry 
along with GPS. 


Leading zeros are shown for all telemetry readings. 


See also: analog 


KPC-3 Plus v 8.2 245 User’s Guide 


Command Reference KPC-3 Plus Commands 


TRACK {ON | OFF} 


default OFF 


When ON, all received frames are displayed in their entirety, in hexadecimal, in- 
cluding all header information. All packets which are eligible for monitoring also 
will be displayed in normal text. 


TRANS 


immediate 


This command causes immediate exit from Command Mode into Transparent 
Mode. The current link state is not affected. There are no special editing charac- 
ters, all characters are sent out as received. To get out of Transparent, send the 
TNC a modem break if BREAK is ON, or see CMDTIME for a special keyboard 
sequence. 


See also: break, cmdtime, command 


TRFLOW {ON | OFF} 


default OFF 


This command allows the TNC to respond to software flow control from the 
computer while in the Transparent Mode. When TRFLOW is OFF, software flow 
control is not used in the Transparent Mode. Hardware flow control will be ex- 
pected from the computer by the TNC. The computer program needs to use hard- 
ware flow control, and the RS-232 cable needs to be wired with CTS and RTS 
connected. When ON, software flow control is enabled and the START and 
STOP characters are sent by the computer to the TNC to control the flow of data. 
When START and STOP are set to $00, hardware flow control must be used. If 
not zero, the TNC will respond to the computer’s START and STOP characters, 
and remain transparent to other characters from the terminal or computer for flow 
control. 
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When START and STOP are set for software flow control (normally <Ctrl+Q> 
and <Ctrl+S>) all characters can be received in Transparent Mode (including the 
START and STOP characters) by setting TRFLOW ON and TXFLOW OFF. You 
will not, however, be able to send the START and STOP characters, since the 
TNC will interpret them as flow control. 


See also: trans, txflow, xflow 


TRIES [n] Ga OS ES) 


The TRIES command will display and optionally set the number of attempts 
which have been made to re-send a packet (on the current stream) which failed to 
reach its destination. For instance, if RETRY is set to 10, TRIES will show how 
many attempts have already been made to pass the data. For example, if TRIES 
were to show 8, “TRIES 3” would reset the counter to make the TNC believe that 
it had only tried 3 times so far, thus allowing 7 more attempts before the RETRY 
limit is exceeded. 


See also: retry 


O TXDELAY n (n = 0 - 255) 


default 30 


This command sets the transmitter key-up delay as 10*n ms. This setting estab- 
lishes the time delay between the application of push-to-talk and the start of 
packet data to the transmitter. Flags (characters to begin packet) are sent during 
the delay. This command needs to be set long enough to give your transmitter 
time to come to full power before data is sent. If set too short the beginning of the 
packet will be chopped off and another station will never be able to decode you. 
If set too long, additional flags at the beginning (heard as a repetitive sound) 
waste air time. It may be necessary to increase your TXDELAY to allow the re- 
ceiving station sufficient time to switch from transmit back to receive to detect 
your signal. 
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TXFLOW {ON | OFF} 


default OFF 


This command allows the TNC to send software flow control (XON and XOFF) 
to stop and restart the flow of data from the computer while in the Transparent 
Mode. When TXFLOW is OFF, hardware flow control must be used between the 
computer and TNC. RTS and CTS must be connected between the TNC and 
computer for hardware flow control. When TXFLOW is ON, software flow con- 
trol between the TNC and computer in Transparent Mode will depend on the set- 
ting of XFLOW. XFLOW ON enables software flow control, XFLOW OFF 
disables it. When software flow control is enabled, the TNC will send the XON 
and XOFF characters to the computer to control data flow. 


When set for software flow control, all characters can be sent in Transparent 
Mode (including the XON and XOFF characters) by setting TXFLOW ON, 
XFLOW ON and TRFLOW OFF. You will not, however, be able to receive the 
START and STOP characters, since your terminal program should interpret them 
as flow control. 


See also: trans, trflow, xflow 


UIDIGI ON [+]|-] calll[,call2[,cal13[,cal14]]] 


default OFF NONE 


Up to 4 call signs can be specified for special digipeater duty. If any of the 
UIDIGI calls appears in the to-be-digipeated field of a UI packet, and if 
MYCALL does not appear in the source field or any of the has-been-digipeated 
fields, the UIDIGI call in the to-be-digipeated field will be replaced by 
MYCALL with the H bit set and the packet will be digipeated. 


See also: dewait, persist, uidwait, unproto 


UIDWATT [ON|OFF] 


default OFF 
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When UIDWAIT is OFF, “special” digipeat packets (those formed by UIDIGI, 
UIFLOOD, or UITRACE only) have their usual channel access; there is no wait 
DWAIT or slottime added before transmission once the channel is clear. How- 
ever, if UIDWAIT is set ON, the packets awaiting to be digipeated will be subject 
to the same wait times as not-to-be-digipeated packets awaiting transmission. 


+ By subjecting “special” to-be-digipeated packets to a delay determined by 
slottime and persist, it is more likely that to-be-digipeated packets of two or more 
stations in the same vicinity would not collide. This may be good if one wants to 
guarantee that a digipeated packet will “make it out” of its neighborhood but bad 
if one wishes to limit the number of times a packet is redigipeated, such as in 
APRS applications. 


See also: dwait, persist, uidwait 


ULIFLOOD name, n, [ID|NOID] (name = 5 char max) (n=0-255) 


default disabled,30,NOID 


When a UI frame is received with a call in the to-be-digipeated field of the form 
“‘name’x-y where x is a number (1-7) appended to ‘name’ and y is a ssid (1-7), 
the ssid is decrement and the UI frame is digipeated without setting the H bit. 
When the packet is digipeated, a checksum is formed over the source, destina- 
tion, and data fields of the packet. This checksum is kept for n seconds (0-255). If 
an incoming UI packet is eligible for digipeating as above, but its checksum 
matches one of those being saved, the packet is discarded (not digipeated). The 
buffer holds a maximum of 64 checksums. If the optional parameter ID is se- 
lected, the MYCALL call sign is inserted in an additional digipeater address field 
with its H bit set. 


See also: uidwait 


UITRACE name, n 


default disabled, 30 


When a UI frame is received with a call in the to-be-digipeated field of the form 
‘name’x-y where x is a number (1-7) appended to ‘name’ and y is a ssid (1-7), 
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and MYCALL does not appear in the source field or any of the 
has-been-digipeated fields, MYCALL with the H bit set is inserted before the 
to-be-digipeated field, the ssid of the to-be-digipeated field is decremented, and 
the UI frame is digipeated without setting the H bit of the to-be-digipeated field. 
The value of n sets a delay time between duplicate digipeats. Use of this “do not 
duplicate within n seconds” feature helps control the number of UI frames 
digipeated. 


+ Ifthe packet should already have 8 digipeater fields, MYCALL is not inserted. 


See also: dwait, persist, uidwait 


O UNPROTO {calll [VIA call2,call3..call9] | NONE} 


default CQ 


calll = destination address (this is really just a “dummy” address, as no connec- 
tion takes place, people often put their name or CQ here) 


call2 ... call9 = optional stations to be digipeated through. A maximum of 8 
digipeat addresses (callsigns or aliases) can be specified. This is referred to as a 
path. 


Each callsign may also have an optional Secondary Station Identifier (SSID) 
specified as -n, where n = 1 - 15. The digipeat callsigns are specified in the order 
in which they are to relay transmitted packets. This command is used to set the 
digipeat and destination address fields for packets sent in the unconnected 
(unprotocol) mode. Unproto packets do not receive an acknowledgment and are 
not retried. They are sent as Unnumbered I-frames <UI>. The digipeater list is 
also used for BEACON and ID packets. If UNPROTO is “NONE”, no uncon- 
nected packets will be sent except for BEACON and ID. Unconnected packets 
sent from other units can be monitored by setting MONITOR ON. If you are con- 
nected, you must also set MCON ON. 


See also: beacon, id, monitor, mrpt, xmitok 
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USERS n (n = 0 - 26) 


default 1 


This command specifies the channels (streams) which may be available to in- 
coming connect requests. For example, if USERS = 5 then an incoming connect 
request will connect to the lowest channel A - E, if any of these channels are in 
the unconnected state. If none of the 5 channels are available (all of them are 
connected), a <<DM> packet will be sent back to the requesting station and the 
message “*** connect request: (call)” will be output to your terminal, if permit- 
ted. If USERS is set to 0 no one will be able to connect to you. If USERS is set 
higher than MAXUSERS, the extra is ignored and the message “USERS 
LIMITED BY MAXUSERS?” will be displayed. 


See also: intface, maxusers, streamsw 


oO 
IK 


ERS ION 


immediate 


This command causes the TNC to display its current version number along with 
the name of the unit. 


WEFAX on 


immediate 


This command permits the reception of Weather Facsimile. The audio input is 
sampled n times per second, and a black/white decision is made on each sample. 
Each sample becomes one bit of the data sent over the serial port to the computer. 
A special computer program must be used to display the WEFAX pictures (such 
as Superfax II, by Kantronics). 


See also: daytweak, WEFAX Reception in Modes of Operations section 
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XFLOW {ON | OFF} 


default ON 


When ON software flow control will be implemented according to the settings of 
START, STOP, XON, XOFF. For normal software flow control set XFLOW ON, 
START $11, STOP $13, XON $11, XOFF $13. The TNC expects the computer or 
terminal to respond to the flow control characters XON and XOFF, and the TNC 
responds to the START and STOP characters from the computer. When XFLOW 
OFF, the TNC will only use and recognize hardware flow control lines (CTS and 
RTS) to start or stop data. The RS-232 cable must be wired appropriately. If the 
software flow control characters are set to $00, software flow control is not possi- 
ble. 


In the Transparent Mode flow control is also determined by the settings of 
TRFLOW and TXFLOW. 


See also: start, stop, trflow, txflow, xoff, xon 


XKCHKSUM {ON | OFF} 


default OFF 


This command only applies when INTFACE is set to XKISS. The value of 
XKCHKSUM controls whether or not the XKISS CHECKSUM mode is active. 


See also: xkpolled 


XKPOLLED {ON | OFF} 


default OFF 


This command only applies when INTFACE is set to XKISS. XKPOLLED con- 
trols whether or not the XKISS POLLED mode is active. 


See also: xkchksum 
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XMITLVL n (n = 0-502) 


default 100 


This command may be used to set the modem drive level. You may find it more 
convenient to use the CAL command in that it allows you to continuously adjust 
drive level by holding down the + or - key while in calibrate mode. 


The voltage range set by the XMITLVL command is from 1 mV to 4 V p-p. From 
a count of 0 to 255, the voltage is increased from 1 mV to (approximately) 130 
mV, or 0.50 mV per step. From a count of 256 and above, the voltage is increased 
linearly but in larger steps (approximately 15 mV per step) until 4 volts (max) is 
reached at a count of 502. 


XMITOK {ON | OFF} 


default ON 


When ON, transmitting functions are enabled. If turned OFF, transmitting is in- 
hibited while all other functions of the TNC are unchanged. 


XOFF n (n = $00 - SFF) 


default $13 <Ctrl+S> 


This command selects the character sent by the TNC to the computer to stop in- 
put from the computer. If set to $00 hardware flow control must be used. For 
software flow control set this parameter to the character the computer expects to 
see to stop sending data to the TNC. 


See also: xflow, xon 


XON n (n = $00 - SFF) 


default $11 <Ctrl+Q> 
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This command selects the character sent by the TNC to the computer to restart 
input from that device. If set to $00 hardware flow control must be used. For 
software flow control set this parameter to the character the computer expects to 
see to restart sending data to the TNC. 


See also: xflow, xoff 
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This appendix gives you additional information on installation and configuration 
beyond that given in the chapters on “Installing your KPC-3 Plus” and 
“Pacterm”. We assume you have already read these chapters. 


Precautions 


The KPC-3 Plus is grounded through its connections to your transceiver, com- 
puter, and power supply. Make sure your transceiver is properly grounded and 
your computer has equal ground potential. Follow the grounding instructions in 
your transceiver manual. 


The two pieces of multi-conductor cable provided with your KPC-3 Plus are 
shielded. If you use other cabling, be certain it is shielded. We do not recommend 
the use of unshielded RS-232 ribbon cable in an amateur radio environment. 


Lithium batteries can explode or leak if heated, disassembled, recharged, exposed 
to fire or high temperature, or inserted incorrectly. 


Cable Wiring 


Caution: Make sure the power to the transceiver, computer, and KPC-3 Plus is 
OFF before connecting any cables. 


The KPC-3 Plus uses a standard RS-232 serial port with a DB-25 connector, con- 
figured as DCE equipment. 


Diagram of Pin Numbers on DB-25 Connector 


The following diagram shows the pin numbering on DB-25 connectors: 


[paste-in DB-25 diagram (see p.94 9612 P] 
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Connecting to the Computer (DB-25) 


The KPC-3 Plus communicates with the computer using RS-232 signaling. This 
is compatible with PC compatible computers, Macintosh, dumb terminal, and 
most other terminal devices. If your computer or terminal uses TTL levels (such 
as the Commodore 64), you will need an after-market converter to supply the 
RS-232 signals required by the KPC-3 Plus. 


Cable Wiring 


All Kantronics software requires five wires between the computer and the KPC-3 
Plus. The pins that must be connected from your KPC-3 Plus to the computer for 
these programs are Txd, Rxd, SG, RTS, and CTS. If you are using other software, 
you should refer to that documentation to determine the cable requirements for 
proper operation. Some software does not support hardware flow control and 
may fail to operate if the RTS and CTS lines are connected. 


The KPC-3 Plus serial port connector has 25 pins, which are configured at the 


factory as: 
Pin KPC-3 Plus Pin Number Computer 
Name Pin Number (DB-25) (DB-9) 
FG Ht 1 N/A 
TXD 2 2 3 
RXD 3 3 2 
RTS 4 4 7 
CTS 5 5 8 
DSR 6 6 6 
SG 7 7 5 
DCD 8 8 1 
DTR 20 20 4 


NOTE: FG (Frame Ground) and SG (Signal Ground) are tied together in the 
KPC-3 Plus. 


The purpose of the pins (by name) is: 


FG - FRAME GROUND: This pin is attached to the chassis of the equipment as 
a safety ground. 
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TXD - TRANSMIT DATA: This line carries the data from your computer to the 
KPC-3 Plus. 


RXD - RECEIVE DATA: This line carries the data from the KPC-3 Plus to your 
computer. 


RTS - REQUEST TO SEND: The KPC-3 Plus checks this line to see if it is per- 
mitted to send data to your computer. This pin is controlled by your computer 
software program to provide this information to the KPC-3 Plus. This pin is used 
for hardware flow control. 


CTS - CLEAR TO SEND: The KPC-3 Plus uses this line to signal your computer 
when it can no longer accept data from the computer, or to signal that it is again 
ready to accept data. This pin is used for hardware flow control. 


DSR - DATA SET READY: This line is set high to indicate that the modem is 
ON. 


DCD - DATA CARRIER DETECT: The KPC-3 Plus uses this pin to signal the 
status of the current I/O stream to your computer. If you are connected to another 
packet station on the current I/O stream, this line will have a positive voltage on 
it. If you are disconnected, the voltage on this line will be negative. 


DTR - DATA TERMINAL READY: Although interconnected via a buffer IC to 
the processor, this line is currently ignored. 


Optional Wiring 


It is possible to re-configure the DB-25 connector to allow some additional func- 
tions through this connector. 


Applying Power through the DB-25 connector. 


If desired, you may apply DC power to the KPC-3 Plus from Pin 13 of the DB-25 
connector. To enable this, connect J6 center pin and pin 2, J7 center pin and pin 
1. 


Resetting the KPC-3 Plus through the DB-25 connector. 


If desired, EXT-IN via pin 13 of the DB-25 connector may be configured to al- 
low you to perform a soft reset. This is accomplished by connecting J6 center pin 
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and pin |, J7 center pin and pin 1. A momentary contact to ground will cause a 
soft reset. 


Hardware handshaking with DSR and DTR. 


It is possible that some terminals or computers use the DTR and DSR pins for 
hardware handshaking instead of the RTS and CTS pins. When this is the case, 
you must connect the DTR terminal output to RTS on the KPC-3 Plus, and con- 
nect the DSR terminal input to CTS on the KPC-3 Plus. 


Software settings 


When using a standard terminal program to communicate with the KPC-3 Plus, 
you must set the serial port configuration in your program for 8 data bits, no par- 
ity, and one stop bit. The baud rates supported by the KPC-3 Plus are 300, 600, 
1200, 2400, 4800, 9600, and 19200. In general you should use the fastest baud 
rate your terminal program and hardware supports. The KPC-3 Plus defaults with 
ECHO ON, so you should set your terminal program for “full-duplex” operation. 


If you are using a baud rate above 9600 baud, we strongly recommend that you 
consider installing special high-speed, buffered UARTS in the serial port of your 
computer. These UARTS are available through many parts suppliers and will im- 
prove the reliability of high-speed communications. You should ask for the 
“high-speed buffered UARTS” (part number 16550 or equivalent) when ordering 
from your supplier. 


Connecting to your Radios 


The 1200 baud radio connector on the KPC-3 Plus rear panel is a 9-pin DB style 
connector, with pin layout as shown below: 


[diagram of DB-9 pin connector] 
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The purposes of each pin are as follows: 


Pin Pin 

number nam Function 
1 TXA Transmit audio (AFSK out) 
2 XCD External carrier detect 
3 PTT 

Push-to-Talk 
4 CTLB(ANO) Control line B(AN@ Analog input)* 
5 RXA Receive audio (AFSK in) 
6 GND Ground 
7 EXT-IN External input for Power/Reset* 
8 CTLA(AN1) Control line A(AN1 Analog input)* 
9 GND/RESET Ground (may be configured as external reset)* 


* See the jumper section for details. 


Pin 1: Connects to the microphone input of your radio, providing the audio signal 
to be transmitted. 


Pin 2: When a ground is applied to this pin, the KPC-3 Plus will not transmit 
packets. This pin is normally used as an external means of supplying carrier 
detect, but can also be used as a “hardware” transmit inhibit. 


Pin 3: When the KPC-3 Plus needs to key your transmitter, it will apply a ground 
to this pin. This is an open-drain circuit and requires a positive voltage from your 
radio (not to exceed 50 volts or 200 mA). 


Pin 4: This pin is the CONTROL B output from the KPC-3 Plus which may be 
used as a control line to your radio or other devices. It is an open-drain circuit, 

and will apply a ground on this pin when controlled by the CTRL command in 

your KPC-3 Plus (not to exceed 50 volts or 200 mA). This pin can also be used 
as ANO (Analog Input). See the Jumper section for details. 


Pin 5: Receive audio from your radio connects to this pin. This normally will 
connect to the external speaker jack on your radio, but may connect to the receive 
audio pin on your microphone connector (if available). 


Pin 6: This pin connects to the ground of your radio mic connector. 
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Pin 7: This pin is not normally connected in the KPC-3 Plus, but may be config- 
ured as an external reset or to supply power to the KPC-3 Plus using jumpers J6 
and J7. See the Jumper section for details. 


Pin 8: This pin is the CONTROL A output from the KPC-3 Plus which may be 
used as a control line to your radio or other devices. It is an open-drain circuit, 

and will apply a ground on this pin when controlled by the CTRL command in 

your KPC-3 Plus (not to exceed 50 volts or 200 mA). This pin can also be used 
as AN1 (Analog Input). See the Jumper section for details. 


Pin 9: This pin is connected to ground as shipped from the factory. You may 
re-configure this pin to perform an external reset by using jumper J5. See the 
Jumper section for details. 


Interfacing Hand-Held Radios 


+ This section is for those who need more information than that given in the “In- 
stallation” chapter. 


Many transceivers, especially most hand-held models, obtain Push-To-Talk key- 
ing by completing a circuit between the mic input and PTT ground. A direct PTT 
input to the mic input line of units with this type electret condenser microphone 
is not usable without some type of isolation. 


If you plan to operate with a hand-held transceiver, the KPC-3 Plus has incorpo- 
rated an isolation circuit which is available by positioning jumper J9 on the cen- 
ter post and the left post (labeled HT) as you face the front of the KPC-3 Plus. 
Should you later use a different type radio, this change may need to be reconfig- 
ured by placing the J9 jumper on the center post and the right post. Most other ra- 
dios of current manufacture will not require any modification of the KPC-3 Plus. 


You may also interface to a hand-held without performing this modification by 
incorporating the same type of circuitry in the cable from your KPC-3 Plus to 
your hand-held. Ground return and speaker audio are both supplied through the 
external speaker jack of your hand-held. 


While you will need to check the exact requirements of your hand-held radio, the 
following guidelines may be useful: 


e ICOM HT radios key the PTT by providing a low impedance path from 
the mic input to ground. To accomplish this, simply install a resistor 
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(approximately 3.9K seems to be a good value) in series with the PTT 
wire from the KPC-3 Plus, and connect this to the mic input along with 
the AFSK line. 


+ The ICOM 2A style wiring is most common, and can be used with some 
Alinco, Azden, and standard HTs. 


e YAESU radios are similar but use a mono plug and a different resistor. 
+ The wiring for Yaesu HTs can also be used with Radio Shack HTs. 


e Most KENWOOD HT radios key the PTT line by connecting the sleeve 
of the mic connector to the sleeve of the earpiece connector. This means 
that you will not need a resistor in the PTT wire from the KPC-3 Plus, 
simply connect the PTT wire to the sleeve of the mic connector. Another 
point to watch — most of the KENWOOD HTs (2600 and later) use a 
three pin mic connector. The AFSK from the KPC-3 Plus should 
therefore connect to the RING and not the TIP of the mic connector. 


+ Leave J9 in normal (not HT) when using Kenwood HTs. 


Optional Connections to DB-9 Radio Port 


Pin 7 of the DB-9 connector may be configured to allow you to apply power to, 
or to perform a soft reset on, your KPC-3 Plus. 


Applying Power through the DB-9 connector. 
To power the KPC-3 Plus from Pin 7 of the DB-9 connector, you must connect J7 


center pin and pin 2, J6 center pin and pin 2. 


Resetting the KPC-3 Plus through the DB-9 connector. 


To perform a soft reset from Pin 7 of the DB-9 connector, you must connect J7 
center pin and pin 2, J6 center pin and pin 1. Momentarily applying a ground to 
pin 7 will then perform a soft reset. 


Alternatively, pin 9 can be used for either ground or reset with jumper J5: Con- 
nect J5 center pin and pin 1| for ground, center pin and pin 2 for external reset. 
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Assembly and Disassembly 


Should you require access to the KPC-3 Plus to reposition jumpers or for other 
purposes, disassemble as follows: 


1. 


8. 


Turn off power to your KPC-3 Plus and remove all cables from the unit. 


Using a small phillips screwdriver, remove the two (2) case screws (located 
on each side of the case) completely. 


Remove the top cover from the unit. NOTE: In most cases, no further disas- 

sembly of the unit is necessary. Only if you need to change a wire jumper or 
solder connections to the PC board should you continue with disassembly of 
your KPC-3 Plus. 


Remove the four (4) hex nuts on the rear panel that secure the DB-9 and 
DB-25 connectors to the case. 


Remove the two (2) screws securing the front panel to the case. 
Remove the front panel. 


Observe proper static protection precautions and gently lift the front edge of 
the PC board to clear the front of the case. 


Pull the PC board forward to remove the PC board from the case. 


To reassemble, reverse the procedure above. 
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Hard Reset 


The hard reset process is provided to re-initialize the KPC-3 Plus to its default 
values. This process may become necessary should operational problems be en- 
countered or when upgrading your firmware to a new version. The readout speci- 
fied in step 5 below will be legible only if your terminal baud rate is 1200. At 
other terminal baud rates, a reset will occur. However, no display readout will be 
observed. This procedure is performed as follows: 


1. Open the KPC-3 Plus by removing the two (2) case screws on the sides of the 
unit and lifting the cover. 


2. Locate the Hard Reset jumper (J11). Jumpers are appropriately labeled on the 
PC board. Refer to the parts location diagram for help in locating them. 


3. Place the jumper on both pins. 
4. Apply power to the KPC-3 Plus. 


5. Observe on the computer display (your terminal program must be set at 1200 
baud): 


CHECKSUM OK 

RAM OK 

32K BYTES [or 128K or 512K as appropriate] 
NO CLOCK 

REPLACE TEST JUMPER 


6. Turn power off. 
7. Return jumper J11 to the normal position (one pin only). 
8. Reassemble the KPC-3 Plus and return to operation. 


Note: After a hard reset, all parameters are at factory default values and any mail- 
box messages are lost. 
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Calibration/Equalization 


The CALIBRAT command is used to assist in adjusting the data transmitter drive 
level and also in adjusting the receive equalization of your KPC-3 Plus. The pro- 
cedures listed below are a guideline for using the calibration command to adjust 
for optimum performance. 


When you issue the CALibrate command, the following options will appear on 
your screen: 


CALIBRATE MODE: 
M send mark 
R receive 
) 
T 


send space 

send square wave 
= Or: adjust XMITLVL while transmitting 
X exit 


Pressing M will transmit a constant MARK (signal) until another key is pressed. 
Pressing R will measure a received square wave. 

Pressing S will transmit a constant SPACE until another key is pressed. 

Pressing T will transmit a square wave (space/mark) until another key is pressed. 


Pressing X will exit the calibrate mode and reset the KPC-3 Plus. 


Drive level. 


The drive level is set by a digital pot, providing a range of I1mV to 4V p-p. De- 
fault drive level is about 50 mV, corresponding to a XMITLVL command set- 
ting/count of 100. After entering the calibrate mode (CAL) you should use the T 
option to initiate the transmission of a square wave and then adjust the AFSK 
drive level by pressing the ‘-’ or ‘+’ key (and holding it down) until you achieve 
the drive level you need. Adjust deviation to achieve about 3 to 3.5 kHz devia- 
tion from your radio. 
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Equalization. 


If you have another Kantronics user nearby, have that station transmit a calibrate 
square wave and choose the R option in your calibrate mode to measure the sta- 
tus of receive equalization. You will see two numbers displayed each time you 
press R. The KPC-3 Plus is measuring the space/mark square wave generated by 
the other station. For best performance, these numbers should be about equal. A 
40/60 to 60/40 ratio is acceptable. Change jumper J4 if need be. Default is no 
equalization, since it’s normally not needed. 


Note: If you are using an High Impedance Data output from the radio, set J3 on one 
in only (OFF = 10K, ON = 620 ohm). 


PTT (Push-to-Talk) Watchdog Timer 


The KPC-3 Plus has a built-in PTT Watchdog Timer. The PTT output will be 
disabled if the TNC has been continuously transmitting for more than approxi- 
mately 3 minutes. 


To disable the Watchdog timer, jumper the pins of J12. 


Microprocessor Watchdog Timer 


The TNC includes a watchdog timer within the microprocessor. In the unlikely 
event that your TNC firmware gets into an infinite loop, the watchdog timer will 
detect the failure and force a reset of the TNC. 
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A/D Converter 


+ 


Two A/D converter inputs are available to the KPC-3 Plus and are used with the 
Analog command. These inputs can be used to measure “DC” external voltages 
from OV to SVDC, with up to 8-bit accuracy. 


Note: If you want to measure voltages greater than +5 VDC, the signals need to at- 
tenuated (by installing resistors R13 or R27 on the printed circuit board) to divide 
them down in voltage. Choose resistance values to scale the desired input voltages 


to 5VDC max at test points “J” or “K” on the printed circuit board. 


It is possible to bring external voltage into the onboard A/D converters from ei- 
ther the Radio Port or the Serial Port using Jumpers J8 or J10. (See the “jumpers” 
section.) 


So, if you jumper the A/D inputs via this port (instead of the RS-232 port) you 
cannot utilize the A/D inputs and control line outputs at the same time. 


Note: Maximum input measurement can be made. Maximum input voltages to 
the A/D inputs should not exceed 50V or damage may occur. 


KPC-3 Plus Jumpers 


Jumper Locations 


+ 


To locate jumpers listed below, use the schematic shipped with the unit and 
(for locations on the printed circuit board) the parts layout in Appendix E. 


Printed 
Schematic Ciruit 
Jumper # Location Location Name 


1 A-6 D-4 battery option 

2 A-6 D-4 battery option 

3 D-2 D-1 modem input impedance 
4 D-2 D-1 equalization 

5 C-1 D-2 ground/reset 

6 B-1 D-2 reset/input 

7 B-1 D-2 serial configuration 
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8 B-1 D-2 analog input ANO 
9 C-1 D-1 normal /HT 

10 B-2 D-2 analog input AN1 
11 C-4 C=3 reset jumper 

12 C-3 C= PTT watchdog 

13 C-6 C=3 ROM size 

14 C-6 A-3 RAM size 

aes) D-4 A-1 na 

16 A-5 B-4 power supply 


J1 and J2: (battery options) These jumpers can be configured several ways. J1 is 
normally OFF, and J2 is normally ON. This allows for power from a 9 volt bat- 
tery to be switched into the circuit when the external power plug is removed. If it 
is desired to have “backup” 9 volt battery power in the event of loss of the exter- 
nal power source, J1 should be ON, and J2 should be OFF. In this case the 9 volt 
battery is isolated from the external power by CR2 which prevents a higher exter- 
nal voltage from being applied across the battery. 


J3: (modem input impedance) This 2-pin jumper, when installed, sets input im- 
pedance of the modem to 600 ohms. When placed on one pin only, input imped- 
ance is set to 10K ohms. Default is 10K ohms. 


J4: (equalization) This two-pin jumper is used to set receive equalization for the 
modem. When placed on both pins, no equalization is selected, and when placed 
on one pin, partial equalization is used. See the calibration/equalization section 
for details. Default is no equalization. 


J5: (DB-9 Ground/reset) This three-pin jumper connects pin 9 of the radio port to 
ground or to the reset circuit. When placed on the center pin and pin 1, pin 9 of 
the DB-9 connector is connected to ground. When placed on the center pin and 
pin 2, pin 9 is connected to the reset circuit. This allows you to perform a soft 
reset by applying a momentary ground to pin 9. Default: ground. 


J6: (Reset/input) This three-pin jumper, in conjunction with jumper J5 or J7 pro- 
vides an alternate means to supply de power to the unit or to perform a reset 
without powering down the unit. See the section on Connector Configuration for 
more details. Default: not connected. 
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J7: (Serial Configuration) This three-pin jumper, in conjunction with J6, provides 
an alternative means to supply dc power to the unit or to perform a reset without 
powering down the unit. See the “Optional Connections” section for more de- 
tails. Default: center pin and pin 2. 


J8: (analog input ANO) When on center pin and pin 1, selects input from DB-9 
pin 4. When placed on center pin and pin 2, selects input from DB-25 pin 18. 


J9: (NOR/HT) When placed on the center pin and the pin marked NOR, this 
configures the AFSK output line for use with base station radios. When placed on 
the center pin and the pin marked HT, this configures the AFSK output line to 
also serve as the PTT line for HT radios. Default: NOR. 


J10: (Analog input AN1) When on center pin and pin 1, selects input from DB-9 
pin 8. When placed on center pin and pin 2, selects input from DB-25 pin 11. 


J11: (Reset Jumper) When on one pin no action occurs. When placed on both 
pins (after turning unit power off), the processor will perform a “hard” reset (and 
internal self-test) once power is turned back on. All command parameters will be 
set to factory default values. Default: not connected. 


J12: (PTT watchdog) This jumper enables/disables the PTT watchdog timer. 
When placed on one pin, the watchdog timer is active; when placed on both pins, 
the timer is disabled. Default: enabled. 


J13: (ROM size) This three-pin jumper permits the installation of different size 
ROMS. When placed on the center pin and 1, ROMs up to/including 1 megabits 
may be installed. When placed on the center pin and 2, ROM sizes | megabits 
and above can be installed. Default: 1 megabit and above. 


J14: (RAM size) This three pin jumper allows the installation of various size 
static RAMs. When placed on the center pin and pin 1, the KPC-3 Plus can ac- 
cept 32K or 128K static RAM. When placed on the center pin and 2, the unit ac- 
cepts a 512K static RAM. Default 32K/128K. 


J16: (Power supply) Internal regulator voltage select (5V/3.3V) Default 5V. For 
details, see the section in this appendix on very low power operation. 
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Low Power Operation 


Your KPC-3 Plus is capable of very low power operation. In order to achieve the 
lowest power consumption possible, you must turn the front panel LEDs off with 
the command LEDS OFF. Also, the modem must be set for INTERNAL carrier 
detection with the command CD INTERNAL. In this configuration, the KPC-3 
Plus will draw less than 15 ma when no signal is being received. Note, however, 
that the actual current drain may vary slightly depending on the RS-232 connec- 
tions to the unit. Some computers will cause the current drain to be slightly 
higher than other computers. 


If you use software carrier detection (CD SOFTWARE) the current drain will be 
higher in the “idle” mode since the processor is actively looking for data even 
when no signal is present. 


Very Low Power Operation 


KPC-3 Plus circuitry is powered from a linear low dropout regulator at 5.0V 
nominal. At this voltage, current requirements vary from approximately 16 ma 
(unit idle and LEDs OFF) to 23 ma (unit transmitting and LEDs ON). By placing 
a jumper on J16, the output of the voltage regulator is reduced from 5.0V to 3.3V 
nominal, thus reducing power requirements nearly in half. The current require- 
ments in this case vary from approximately 8.5 ma (unit idle and LEDs OFF) to 
12 ma (unit transmitting and LEDs ON). 


The 3.3 volt mode of operation has not been thoroughly tested in the field and is 
not guaranteed. The unit may not function properly over extreme temperature 
ranges when operating at 3.3 volt. 
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Expanding the RAM in the KPC-3 Plus 


The KPC-3 Plus is available with 32K bytes or 128K bytes of RAM. It is possi- 
ble to expand the RAM in the KPC-3 Plus from 32K to 128K, or up to a maxi- 
mum of 512K bytes. 


There are two possibilities. 


1. Ifyou have 32K of RAM and you wish to expand the RAM to 128K, simply 
remove the existing 32K static RAM from socket U14 and install a 128K x 8 
static RAM (P/N 628128 or equivalent) in its place. Be sure the notch indi- 
cating pin | of the RAM chip is pointed toward the left edge (facing the 
front) of the KPC-3 Plus. Notice also that the 32K RAM chip has its pin 1 
pointing left, but it seats as far right in the socket as possible (leaving 4 pins 
open to the left). 


2. Expanding the RAM to 512K bytes requires that you: (1) remove the existing 
32/128K RAM in socket U14, (2) change jumper J14 to the center pin and 
pin 2 (to left of the RAM chip), then (3) install a 512K low-power static 
RAM in U1/4, with the pin | end of the IC toward J14. 


Installing the Optional Real-Time Clock Module 


The Real-Time clock option for the KPC-3 Plus consists of a FOX 72421 
self-contained clock chip. 


Install the clock chip with pin 1 toward the right (as you are looking at the unit) 
in socket U16. 


You will need to initialize the clock with the current date and time after installing 
the clock chip. Just enter the DAYTIME as described in the commands section 
of this manual. The Real-Time clock is read when the KPC-3 Plus is powered 
on, or when a soft reset occurs. 
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Replacing the Lithium Battery 


To replace the internal Lithium battery, remove the cover from your KPC-3 Plus 
and carefully slip the battery out of the battery holder. You may need to use an in- 
sulated tool to assist in removal of the battery. When installing a replacement bat- 
tery (CR 2032 or equivalent), be sure you have the positive terminal against the 
top clip of the battery holder. 


NOTE: When you remove the lithium battery from your KPC-3 Plus, all stored 
parameters will be lost and the unit will revert to the factory default parameters. 
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+ Additional possible difficulties are covered in the “Trouble-Shooting” section of 
the “Pacterm” chapter. 


Your Kantronics KPC-3 Plus is manufactured to very stringent quality standards. 
If you have followed the installation procedures outlined in this manual, it is 
highly unlikely that you will encounter a failure. If you do have difficulty, use the 
procedures described in this section to assist in isolating and correcting the prob- 
lem. 


KPC-3 Plus Does Not “Sign-On” to Computer 


1. 


Carefully recheck cabling between your computer serial port and the KPC-3 
Plus. 


Check carefully to insure that the Transmit Data, Receive Data, and Ground 
leads are connected to the proper pins. 


If you have made a 5 wire connection to the computer serial port, change to a 
3 wire connection. To use Pacterm, you need a 5 wire connection, so if you 
change to a 3 wire connection, you will need to use another terminal commu- 
nication program. 


Check your terminal program to be certain it is configured with the correct 
communications parameters (serial port, baud rate, parity). 


Try a “Hard Reset” using the Hard Reset jumper. (Operate your terminal pro- 
gram at 1200 baud when performing a hard reset.) 


You Are Unable to Make a “Connect” 


1. 


Issue a connect request and observe the TNC’s XMIT LED. If the XMIT 
LED illuminates, check to insure that the radio is connected to the radio port. 
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If the XMIT LED does not illuminate, check to be sure the XMITOK com- 
mand is turned ON. 


2. Observe the radio to determine if it is being switched to the “Transmit” con- 
dition. If not, recheck wiring between the KPC-3 Plus radio port, PTT pin, 
and ground on the microphone jack. 


3. Set the CD command to INTERNAL and turn the radio squelch control to 
“OFF” and see if the RCV LED illuminates on the packet controller. If it 
does not light, recheck the audio connection between your transceiver and 
the KPC-3 Plus. 


4. Ifpossible, monitor your transmitted signal with another radio. If the trans- 
mitter is keying to “Transmit” but weak or no audio is monitored, increase 
AFSK output as necessary using R-13. (See the AFSK Output Level section.) 


Cannot Transmit 
1. Check the XMITOK command — it must be ON to allow transmitting. 


2. Ifusing a “fixed level” (i.e., the RCV LED stays on all the time) Receive Au- 
dio from the radio, which the volume and squelch do not change, so set the 
CD parameter to SOFTWARE. 


Cannot Return to Command Mode 


1. The single most common cause of this is that the STOP character (and usu- 
ally XOFF) have been inadvertently set to the same as the COMMAND char- 
acter. This is usually caused by the use of the dollar sign ($) as a 
streamswitch. If you use the $, be aware that you cannot enter hex values 
without PASSing the dollar sign. Symptoms for this usually are that you can 
talk to the KPC-3 Plus fine in Command Mode, you can usually talk to others 
on the air, but you just can’t get back to Command Mode. With most PC ter- 
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minal programs, pressing <Ctrl+C> will display the heart character, but you 
still don’t get the cmd: prompt. 
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Specifications 


Size: 0.8" x 5.2" x 5.2" (21 mm x 133 mm x 133 mm) 
Weight: 11oz (0.32kg) 
Power Requirements: 


6 VDC to 25 VDC, less than 30 ma (LEDS on, unit active) 
6 VDC to 25 VDC, less than 15 ma (LEDS off, unit inactive) 


Power Plug Polarity: Center pin positive 

Watch Dog Timer: Approximately 2-1/2 minutes 
External Carrier Detect (XCD): Pulldown to ground 
External Reset: Pulldown to ground 

PTT Output: Open drain, +50 VDC max, 200 ma max 
Audio Output: 


Continuously adjustable: 1 mvpp-4vpp 
Output Impedance (ac coupled): 600 ohm 


Modulation: 1200 bps FSK, full duplex 
CCITT V.23 (1300 Hz / 2100 Hz) 
Audio Input: 


Input Sensitivity: 5 mv p-p 

Dynamic Range: 70dB 

Input Impedance (unbalanced): 10K ohm (600 with Jumper J3 installed) 
Max Input Voltage: +/-12 VDC; 35 V p-p sinusoidal 


Modes of Operation Packet, WeFax, KISS, XKISS, Host, GPS 
Other Features: PBBS, KA-NODE, Remote Access, and, as an option, K-Net 
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Messages from the KPC-3 Plus 


The following are brief explanations of the most important messages that may be 


sent by your TNC. 


Note: Since these messages are also sent by other Kantronics’ TNCs, they refer to 


“TNC”, not to “KPC-3 Plus”. 


**k* (callsign) busy 


The packet station you were attempting to connect to (callsign) is unable to 


accept connects, and responded with a busy signal. 


Already connected on stream n 


You are attempting to connect to someone you are already connected to on 
another stream. The STATUS command will show you who you are con- 


nected to and on what stream (i.e., stream “n’’). 


BBS BUSY 


You have attempted to connect to your own PBBS, but the BBS is in use by 


another station. 


CALIBRATE MODE: 
M send mark 
R receive 
Ss send space 
T send square wave 


- or + adjust XMITLVL while transmitting 


Xx exit 


This message appears on your screen when you enter the Calibrate Mode, 
and prompts you to press M to generate a MARK tone, R to receive a 
Kantronics Calibrate signal, S to generate a SPACE tone, T to transmit a 
Kantronics Calibrate signal, - or + to adjust XMITLVL while transmitting, 


or X to return to the Command Mode. 
Can’ t DISCONNECT 


You are not connected on this stream so therefore cannot disconnect. This 
message will be followed by the stream and a “Link state is:” message, de- 


scribed later in this section. 
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Can’ t RECONNECT 


You have attempted to reconnect to a station (by issuing a CONNECT com- 
mand) but the callsign you entered is not the same as the station you are al- 
ready connected to. You may only reconnect to the station you are connected 
to on this stream. 

CHECKSUM ERROR 


This message indicates that the Kantronics firmware in your TNC may be 
damaged. You may see this message when performing a hard reset, or any 
time a soft reset is performed (including initial power up), and an EPROM 
error is detected. 

CHECKSUM OK 


When performing a hard reset, this message indicates that the Kantronics 
firmware Eprom has passed the internal checksum test. 


cmd: 


This is the Command Mode’s prompt for input. Any characters entered after 
the TNC prints “cmd:” will be used as command input and not packet data. 


Command not available in NEWUSER mode 


This message indicates that you have attempted to change one of the 
commands in the TNC, but that command is not currently available to you. 
This occurs when the INTFACE command is set to NEWUSER. To enable 
all commands, set INTFACE TERMINAL. 


*** connect request: 


A remote packet station has attempted to connect to you, but there is not a 
valid stream available for the connection. The remote station will be sent a 
busy message, packet. See the USERS and MAXUSERS commands for set- 
ting more streams and allowing more connects at one time if desired. Also be 
sure CONOK is ON. 


*** CONNECTED to call [VIA digil....digi8] 
A packet connection has taken place. This can happen by you issuing a con- 
nect request or a connect request coming in from a remote station. “call” will 


be the callsign entered in the remote stations MYCALL and if a path was 
used it will be shown. 


*** DISCONNECTED 
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The packet connection no longer exists. 
EH? 
This is the TNC’s generalized “I don’t understand” message. A dollar sign 
($) is used to point to the offending character. It will also appear if a required 
input item is missing, e.g.: 
C KV7B V 


EH? 

In this example, the required callsign after the VIA option is missing. Most 
commands that receive an EH? error are ignored. In a few cases, part of the 
command may be accepted and acted upon, as described under the message 
“Input ignored”. 

ENTER YOUR CALLSIGN=> 
Type in your callsign. The TNC needs to know who you are to properly im- 
plement its protocol. Your callsign will be placed in the MYCALL parameter 
and used to generate the MYNODE and MYPBBS callsigns, and the 
CWIDTEXT. 

XxXxx FREE BYTES 


This message indicated how many additional characters may be entered into 
the TNC packet buffer before the buffer is full. 


***FRMR received: 
A frame reject packet has been received for an unknown reason. The infor- 
mation field of this packet will display in hexadecimal value. This display 
may be useful in determining why the receiving station rejected your packet. 
***xFRMR sent: 
Frame reject packet has been sent due to a detected error in protocol. Three 
bytes (6 hexadecimal characters) are displayed to assist in determining the 
reason for the reject. 
Input ignored 
Since the TNC command interpreter was kept small and simple, it will some- 
times change parameters before it completes parsing some of the more in- 


volved commands. In some cases, options at the beginning of the command 
will have been acted on before a syntax error near the end of the line is 
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reached. When this occurs, “Input ignored” is used to show what part of the 
line was ignored. The dollar sign points to the boundary: characters to the left 
were used; the character pointed to and those to the right were not, 1.e., the 
line was parsed as if a <CR> was entered at the $. 


Example: 


BUDLIST QST,KB@NYK N@KN 
$ 


Input ignored 
Because the comma is missing, the command is interpreted as if it were 
BUDLIST QST,KBONYK; the NOKN is ignored. 

INVALID STREAM 
The stream you have tried to change to is not valid. Stream designators must 
be letters A - Z. MAXUSERS sets the upper limit on valid streams. The set- 
ting of LCSTREAM determines if lower-case characters are permitted when 
switching streams. 


KANTRONICS PACKET CONTROLLER III PLUS VERSION 7.0 
(C) COPYRIGHT 1988-1997 BY KANTRONICS INC. ALL RIGHTS RESERVED. 
DUPLICATION PROHIBITED WITHOUT PERMISSION OF KANTRONICS. 


A message such as this (different for each product, but with this format) ap- 
pears when the TNC is first turned on and after any soft reset, including 
changing the NUMNODES, PBBS, MAXUSERS or MYREMOTE com- 
mands, or issuing the RESET command. 

Link state is: 
This message is output in response to the CONNECT and DISCONNECT 
commands if the state of the link does not permit the requested action. It is 
prefaced by “Can’t CONNECT” or “Can’t DISCONNECT?” as appropriate 
and will be followed by the current link state. ACONNECT command with 
no options will display the link state of the current stream. 


Current link states are: 

Both devices busy 

Both TNCs involved in the connection are unable to accept any more data. 
CONNECTED to (callsign v path) 
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Your TNC is currently connected to the indicated station, using the path 
given. 


CONNECT in progress 
Your TNC is attempting to establish a connection. 
Device busy 


Your TNC is unable to accept any more data from the remote station at this 
time. 


DISC in progress 

Your TNC is attempting to disconnect from another station. 
DISCONNECTED 

No connection exists on the current stream. 

FRMR in progress 


Your TNC has detected an error in the protocol. This is normally caused by 
two TNCs using the same callsign, resulting in both of them trying to re- 
spond to the same message. 

Remote device busy 

The remote TNC is unable to receive any more data from the radio at this 
time. 

Waiting ACK and device busy 

Your TNC has sent a packet to another station and is waiting for the ac- 
knowledgment, but your TNC is not able to accept any data from the radio at 
this time. 

Waiting ACK and remote busy 

Your TNC has sent a packet to another station and is waiting for the ac- 


knowledgment, and the remote TNC is not able to accept any data from the 
radio at this time. 


Waiting ACK and both devices busy 


Your TNC has sent a packet to another station and is waiting for the ac- 
knowledgment, but neither your TNC nor the other station’s TNC is able to 
accept any data from the radio at this time. 


Waiting acknowledgment 
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You have sent a packet of data to another station, and your TNC is waiting 
for the acknowledgment. 


MESSAGES WOULD BE LOST 


This message indicates that you have attempted to set the PBBS size too 
small to hold all of the existing messages in the mailbox. The size is not 
changed, and therefore no messages are lost. If you want to make the mail- 
box smaller, you must first delete some of the messages or set the PBBS to 0, 
erasing all of the messages, then set the new PBBS size. 


NO KNOWN NODES 
An NDHEARD list has been requested and the TNC has not heard any other 
nodes (e.g., KA-Nodes). 

NOT ENOUGH RAM 
This message indicates that you have attempted to set the NUMNODES, 
MAXUSERS, or PBBS to a value which requires more RAM memory than is 
currently available. It may also occur if you try to enable the MYREMOTE 
and there isn’t enough memory left. 

Not while connected 
Some parameters cannot be changed if the TNC is connected to another sta- 
tion. This message is printed if an attempt is made. 

PBBS MESSAGE BUFFER NOT VALID! 

TRYING TO RECOVER 
When you turn on the TNC a check is made of the pointers relating to the 
PBBS. It appears that one or more of these pointers may not be correct. An 
attempt is made to correct them, but it is possible that some or all of the mes- 
sages may be lost. 

PRESS (*) TO SET BAUD RATE 
You need to press the asterisk (*) key on your keyboard within two seconds 
of seeing this message. The KPC-3 Plus’s autobaud routine will then detect 
what baud rate your computer is using, so the two devices can communicate. 

RAM OK xxxK BYTES 
This message appears when a hard reset is performed and indicates that the 


TNC has tested the installed RAM and has found no problems. It also reports 
the amount of RAM installed in your TNC. 
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RAM ERROR xxxK BYTES 
If this message appears when you perform a hard reset, the TNC has detected 
a problem with the installed RAM, and reports how much of the RAM it 
found. 

*x*kretry count exceeded 

*** DISCONNECTED 
The number of tries set by the RETRY command has been exceeded. There- 
fore the connection has been broken. 

soo 
This message from the TNC indicates that it is in the HOST mode of opera- 
tion, and has just performed a reset. To exit the Host mode, you must send 
three characters to the TNC from your keyboard. See the Host mode section 
of the manual for details. Two FEND characters precede this message and 
one FEND character follows this message, but they may not be visible (de- 
pending on your terminal program). 

Value out of range 
If the syntax of the command is legal, but the value specified is too large or 
too small for this command, the value out of range message is returned. A $ 
is used to point to the bad value. 

was 
Whenever one of the parameters is changed, the previous value is usually 
displayed. 
Example: 


emd:AX25 OFF 
AX25L2V2 was ON 
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ASCII Chart 


[paste in page | of 2 ASCII chart] 
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ASCH CHART, continued 


[paste in page | of 2 ASCII chart] 
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KPC-3 Plus Parts List 


(copy/paste-in — page | of PARTS list (from p.123))] 


User’s Guide 290 KPC-3 Plus v8.2 


KPC-3 Plus Parts List Appendix E: Additional Information 


(copy/paste-in — page 2 of PARTS list (from p.124))] 
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KPC-3 Plus Parts Layout 
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